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laravel 源码 详解 
laravel 是 一 个 非常 简洁 、 优 雅 的 _ PHP 开发 框架 。 laravel 中 除了 提供 最 为 
中 心 的 Ioc 容器 之 外 ， 还 提供 了 强大 的 BH 、 数据 库 模 型 等 常用 功能 模块 。 


对 于 开发 者 来 说 ， 在 使 用 laravel 框架 进行 web 开发 的 同时 ， 一 定 很 好 奇 
laravel 内 部 各 个 模块 的 原理 ， 知 其 然 更 知 其 所 以 然 ， 有 助 于 提供 开发 的 稳定 与 


本 项 目 针对 laravel 5.4 各 个 重要 模块 的 源码 进行 了 较为 详尽 的 分 析 ， 希 望 给 
想 要 了 解 laravel 底层 原理 与 源码 的 同学 一 些 指引 。 


由 于 本 人 能 力 有 限 ， 文 章 中 可 能 会 有 一 些 问 题 ， 效 请 提出 意见 与 建议 ， 谢谢 。 


GitBook 地 址 : https://www.gitbook.com/book/leoyang90/laravel-source-analysis 


这 篇 文章 是 对 PHP 自 动 加 载 功能 的 一 个 总 结 ， 内 容 涉 及 PHP 自 动 加 载 功 能 ^ PHP 
命名 空间 ^ PSRO/PSR4 标 准 FAR o 


一 、PHP 目 动 加 载 功能 


PHP 目 动 加 载 功 能 的 由 来 


在 PHP 开发 过 程 中 ， 如 果 硕 望 从 外 部 引入 一 个 Class ， 通 常会 使 用 include 和 
require 方法 ， 去 把 定义 这 个 Class 的 文件 包含 进来 。 这 个 在 小 规模 开发 的 时 
人 息 ， 没 什么 大 问题 。 但 在 大 型 的 开发 项 目 中 ， 使 用 这 种 方式 会 带 来 一 些 隐 含 的 问 
题 : 如 果 一 个 PHP 文件 需要 使 用 很 多 其 它 类 ， 那 么 就 需要 很 多 的 
require/include 语句 ， 这 样 有 可 能 会 造成 遗漏 或 者 包含 进 不 必要 的 类 文件 。 
如 果 大 量 的 文件 都 需要 使 用 其 它 的 类 ， 那 么 要 保证 每 个 文件 都 包含 正确 的 类 文件 肯 
A —^4-3& > IE require once 的 代价 很 大 。 
PHP5 为 这 个 问题 提供 了 一 个 解决 方案 ， 这 就 是 类 的 自动 加 载 (auto1load ) 机 
制 。 autoload 机 制 可 以 使 得 PHP 程序 有 可 能 在 使 用 类 时 才 自 动 包 含 类 文件 ， 
而 不 是 一 开始 就 将 所 有 的 类 文件 include 进来 ， 这 种 机 制 也 称 为 Lazy loading 
(ERR) 。 
e 总 结 起 来 ， 自 动 加 载 功 能 带 来 了 几 处 优点 : 


1. 使 用 类 之 前 无 需 include / require 
2. 使 用 类 的 时 候 才 会 include / require 文件 ， 实 现 了 lazy 
loading ， 避 免 了 include / require 多 余 文 件 。 
3. 无 需 考 虑 引入 类 的 实际 磁盘 地 址 ， 实 现 了 逻辑 和 实体 文件 的 分 离 。 
e 如 果 想 具体 详细 的 了 解 关 于 自动 加 载 的 功能 ， 可 以 查看 资料 : 
PHP 类 自动 加 载 机 制 


PHP autoload 机 制 的 实现 解析 


PHP 4 z7«Z i£ autoload() 


。 Me M be ， 如 果 发 现 这 个 类 没有 加 载 ， 就 会 自动 运行 
. autoload() 六 数 ， 这 个 函数 是 我 们 在 程序 中 自 定义 的 ， 在 这 个 函数 中 我 们 可 
esi end 下 面 是 个 简单 的 示例 : 


<?php 
function _ autoload($classname) { 
require_once ($classname . ".class.php"); 


e 在 我 们 这 个 简单 的 例子 中 ， 我 们 直接 将 类 名 加 上 扩展 名 .class.php 构成 了 
类 文件 名 ， 然 后 使 用 require_once 将 其 加 载 。 


从 这 个 例子 中 ， 我 们 可 以 看 出 autoload 至 少 要 做 三 件 事情 : 
. 根据 类 名 确定 类 文件 名 ; 

2. 确定 类 文件 所 在 的 磁盘 路 径 (在 我 们 的 例子 是 最 简单 的 情况 ， 类 与 调用 它 
们 的 PHP 程 序 文件 在 同一 个 文件 夹 下 ) 

3. 将 类 从 磁盘 文件 中 加 载 到 系统 中 。 

e 第 三 步 最 简单 ， 只 需要 使 用 include / require 即 可 。 要 实现 第 一 步 ， 第 
二 步 的 功能 ， 必 须 在 开发 时 约定 类 名 与 磁盘 文件 的 映射 方法 ， 只 有 这 样 我 们 才 
能 根据 类 名 找到 它 对 应 的 磁盘 文件 。 

e 当 有 大 量 的 类 文件 要 包含 的 时 候 ， 我 们 只 要 确定 相应 的 规则 ， 然 后 在 
. autoload() 号 数 中 ， 将 类 名 与 实际 的 磁盘 文件 对 应 起 来 ， 就 可 以 实现 


lazy loading 的 效果 。 从 这 里 我 们 也 可 以 看 出 ”autoload() BANS 
现 中 最 重要 的 是 类 名 与 实际 的 磁盘 文件 映射 规则 的 实现 


. autoload() 函数 存在 的 问题 


e 如 果 在 一 个 系统 的 实现 中 ， 如 果 需 要 使 用 很 多 其 它 的 类 库 ， 这 些 类 库 可 能 是 由 
不 同 的 开发 人 员 编 写 的 ， 其 类 名 与 实际 的 磁盘 文件 的 映射 规则 不 尽 相 同 。 这 时 
如 果 要 实现 类 库 文件 的 自动 加 载 ， 就 必须 在 _autoload() 函 数 中 将 所 有 的 映射 
规则 全 部 实现 ， 这 样 的 话 __autoload() eh di 复杂 ， 其 至 无 法 


实现 。 最 后 可 能 会 导致 ”autoload() 函数 十 分 膝 肿 ， 这 时 即便 能 够 实现 ， 
也 会 给 将 来 的 维护 和 系统 效率 带 来 很 大 的 负面 影响 。 


。 那 么 问题 出 现在 哪里 呢 ? 问题 出 现在 autoload(’) 是 全 局 函数 只 能 定义 一 次 
;不够 灵活 ， 所 以 所 有 的 类 名 与 文件 名 对 应 的 逻辑 规则 都 要 在 一 个 函数 里 面 实 
现 ， 造 成 这 个 函数 的 肥 肿 。 那 么 如 何 来 解决 这 个 问题 呢 ? 答案 就 是 使 用 一 个 
__autoload 调 用 堆栈 ， 不 同 的 映射 关系 写 到 不 同 的 — autoloadhe 中 去 ， 
然后 统一 注册 统一 管理 ， 这 个 就 是 PHP5 引 入 的 SPL Autoload 。 


SPL Autoload 


e SPL X Standard PHP Library( 标 准 PHP 库 ) 的 缩写 。 它 是 PHP5 引 入 的 一 个 扩展 
库 ， 其 主要 功能 包括 autoload 机 制 的 实现 及 包括 各 种 lterator 接 口 或 类 。SPL 
Autoload 上 有 具 体 有 几 个 函数 : 


ji 
. spl autoload unregister : 注销 已 注册 的 函数 

. spl autoload functions : 返回 所 有 已 注册 的 函数 

. spl autoload call : 尝试 所 有 已 注册 的 函数 来 加 载 类 

. spl autoload : autoload() 的 默认 实现 

. spl autoload extionsions : 注册 并 返回 Spl_autoloaa 子 数 使 用 的 默认 


oon 上 hM 


spl autoload register : 1£7t__autoload() $% 4% 


文件 扩展 名 。 


todo Continue 


todo Continue 


todo Continue 


todo Continue 


todo Continue 


todo Continue 


这 几 个 函数 具体 详细 用 法 可 见 php Y spl_autoload+ f£ 


简单 来 说 ，spl_autoload 就 是 SPL 自己 的 定义 autoload() 函数 ， 功 能 很 
简单 ， 就 是 去 注册 的 目录 (由 set_include_path 设 置 ) 找 与 $classname 同 名 的 .phpl.inc 
文件 。 当 然 ， 你 也 可 以 指定 特定 类 型 的 文件 ， 方 法 是 注册 扩展 名 
(spl autoload extionsions) ° 


而 splautoload register() 就 是 我 们 上 面 所 说 的 ，autoload 调 用 堆栈 ， 我 们 可 以 
向 这 个 函数 注册 多 个 我 们 自己 的 _autoload() 亟 数 ， 当 PHP 找 不 到 类 名 时 ，PHP 就 会 
调用 这 个 堆栈 ， 一 个 一 个 去 调用 自 定义 的 _autoload() 函 数 ， 实 现 自动 加 载 功 能 。 如 
果 我 们 不 向 这 个 函数 输入 任何 参数 ， 那 么 就 会 注册 spl_autoload() 函 数 。 


好 啦 ，PHP 自 动 加 载 的 底层 就 是 这 些 ， 注 册 机 制 已 经 非常 灵活 ， 但 是 还 缺 什 么 
R? 我 们 上 面 说 过 ， 自 动 加 载 关键 就 是 类 名 和 文件 的 映射 ， 这 种 映射 关系 不 同 框 架 
有 不 同方 法 ， 非 常 灵活 ， 但 是 过 于 灵活 就 会 显得 杂乱 ，PHP 有 专门 对 这 种 映射 关系 
的 规范 ， 那 就 是 PSR 标 准 中 PSR0 与 PSR4 ° 


不 过 在 谈 PSR0 与 PSR4 之 前 ， 我 们 还 需要 了 解 PHP 的 命名 空间 的 问题 ， 因 为 这 
两 个 标准 其 实 针 对 的 都 不 是 类 名 与 目录 文件 的 映射 ， 而 是 命名 空间 与 文件 的 映射 。 
为 什么 会 这 样 呢 ? 在 我 的 理解 中 ， 规 范 的 面向 对 象 PHP 思 想 ， 命 名 空间 在 一 定 程度 
上 算是 类 名 的 别名 ， 那 么 为 什么 要 推出 命名 空间 ， 命 名 空间 的 优点 是 什么 呢 


二 、Namespace 命 名 空间 


要 了 解 命名 空间 ， 首 先 先 看 看 官方 文档 中 对 命名 空间 的 介绍 : 


'HP Composer— 

什么 是 命名 空间 ? 从 广义 上 来 说 ， 命 名 空间 是 一 种 封装 事物 的 方法 。 在 很 
多 地 方 都 可 以 见 到 这 种 抽象 概念 。 例 如 ， 在 操作 系统 中 目录 用 来 将 相关 文件 分 
组 ， 对 于 目录 中 的 文件 来 说 ， 它 就 扮演 了 命名 空间 的 角色 。 具体 举 个 例子 ， 
文件 foo.txt 可 以 同时 在 目录 /home/greg 和 /home/other 中 存在 ， 
但 在 同一 个 目录 中 不 能 存在 两 个 foo.txt 文件 。 另 外 ， 在 目录 /home/greg 外 
访问 foo.txt 文件 时 ， 我 们 必须 将 目录 名 以 及 目录 分 隔 符 放 在 文件 名 之 前 得 
到 /home/greg/foo.txt 。 这 个 原理 应 用 到 程序 设计 领域 就 是 命名 空间 的 概 


a 


o 


在 PHP 中 ， 命 名 空间 用 来 解决 在 编写 类 库 或 应 用 程序 时 创建 可 重用 的 代码 
如 类 或 函数 时 碰 到 的 两 类 问题 : 


1. 用 户 编 号 的 代码 与 PHP 内 部 的 类 /函数 /常量 或 第 三 方 类 /函数 /常量 之 间 的 
名 字 冲 突 * 


2. 为 很 长 的 标识 符 名 称 (通常 是 为 了 缓解 第 一 类 问题 而 定义 的 ) 创 建 一 个 别 
名 (或 简短 ) 的 名 称 ， 提 高 源 代码 的 可 读 性 。* 


PHP 命名 空间 提供 了 一 种 将 相关 的 类 、 郊 数 和 常量 组 合 到 一 起 的 途径 。 


简单 来 说 就 是 PHP 是 不 允许 程序 中 存在 两 个 名 字 一 样 一 样 的 类 或 者 函数 或 
者 变量 名 的 ， 那 么 有 人 就 很 疑惑 了 ， 那 就 不 起 一 样 名 字 不 就 可 以 了 ? 事实 上 很 多 大 
程序 依赖 很 多 第 三 方 库 ， 名 字 冲 突 什么 的 不 要 太 常 见 ， 这 个 就 是 官网 中 的 第 一 个 问 
题 。 那 么 如 何 解决 这 个 问题 呢 ? 在 没有 命名 空间 的 时 候 ， 可 怜 的 程序 员 只 能 给 类 名 
会 发 生 冲 突 了 ， 但 是 这 样 长 的 类 名 编写 起 来 累 ， 读 起 来 更 是 难受 。 因 此 PHP5 就 推 
出 了 命名 空间 ， 类 名 是 类 名 ， 命 名 空间 是 命名 空间 ， 程 序 写 /看 的 时 候 直接 用 类 名 ， 
运行 起 来 机 器 看 的 是 命名 空间 ， 这 样 就 解决 了 问题 。 


另外 ， 命 名 空间 提供 了 一 种 将 相关 的 类 、 函 数 和 常量 组 合 到 一 起 的 途径 。 这 
是 面向 对 象 语言 命名 空间 的 很 大 用 途 ， 把 特定 用 途 所 需要 的 类 、 变 量 、 函 数 写 到 一 
个 命名 空间 中 ， 进 行 封装 。 


解决 了 类 名 的 问题 ， 我 们 终于 可 以 回 到 PSR 标 准 来 了 ， 那 么 PSR0 与 PSR4 是 怎 
么 规范 文件 与 命名 空间 的 映射 关系 的 呢 ? 答案 就 是 : 对 命名 空间 的 命名 ( 额 ， 有 
点 绕 ) 、 类 文件 目录 的 位 置 和 两 者 映射 关系 做 出 了 限制 ， 这 个 就 是 标准 的 核心 


更 完整 的 描述 可 见 现代 PHP 新 特性 系列 (一 ) 命名 空间 





Z ` PSR Ë 


在 说 PSR0 与 PSR4 之 前 先 介绍 一 下 PSR 标 准 。PSR 标 准 的 发 明 者 和 规范 
者 是 : PHP-FIG， 它 的 网 站 是 : www.php-fig.org。 就 是 这 个 联盟 组 织 发 明和 创造 了 
PSR-[0-4] 规 范 。FIG 是 Framework Interoperability Group 〈 框 架 可 互 用 性 小 组 ) 
的 缩写 ， 由 几 位 开源 框架 的 开发 者 成 立 于 2009 年 ， 从 那 开 始 也 选取 了 很 多 其 他 成 
员 进 来 ， 虽 然 不 是 “官方 ” 组织， 但 也 代表 了 社区 中 不 小 的 一 块 。 组 织 的 目的 在 于 : 
以 最 低 程 度 的 限制 ， 来 统一 各 个 项 目的 编码 规范 ， 避 免 各 家 自行 发 展 的 风格 阻碍 了 
程序 设计 师 开 发 的 困扰 ， 于 是 大 伙 发 明和 总 结 了 PSR，PSR 是 Proposing a 
Standards Recommendation (提出 标准 建议 ) 的 缩写 ， 截 止 到 目前 为 止 ， 总 共有 5 
套 PSR 规 范 ， 分 别 是 : 


PSR-0 (Autoloading Standard) 自动 加 载 标 准 

PSR-1 (Basic Coding Standard) 基 础 编码 标准 

PSR-2 (Coding Style Guide) 编码 风格 向 导 

PSR-3 (Logger Interface) 日 志 接 口 

PSR-4 (Improved Autoloading) 自动 加 载 的 增强 版 ， 可 以 替换 掉 PSR-0 了 。 


具体 详细 的 规范 标准 可 以 查看 PHP 中 PSR-[0-4] 规 范 


PSR0 标 准 


PRS-0 规 范 是 他 们 出 的 第 1 套 规 范 ， 主 要 是 制定 了 一 些 自动 加 载 标准 
(Autoloading Standard) PSR-0 强 制 性 要 求 几 点 : 


PHP Composer 一 一 自动 加 载 原理 


1. 一 个 完全 合格 的 namespace 和 class 必 须 符 合 这 样 的 结构 : «vendor 
Name>[<Namespace>]*<Class Name> 


2. 每 个 hamespace 必 须 有 一 个 顶层 的 namespace ("Vendor Name" 提 供 者 名 
字 ) 
3. 每 个 hamespace 可 以 有 多 个 子 namespace 


4. 当 从 文件 系统 中 加 载 时 ， 每 个 namespace 的 分 隔 符 (/) 要 转换 成 
DIRECTORY _SEPARATOR( 操 作 系 统 路 径 分 隔 符 ) 


5. 在 类 名 中 ， 每 个 下 划 线 (_) 符号 要 转换 成 DIRECTORY_SEPARATOR( 操 作 系 
统 路 径 分 隔 符 ) 。 在 namespace 中 ， 下 划 线 _ 符号 是 没有 (特殊 ) 意义 
的 。 


6. 当 从 文件 系统 中 载 入 时 ， 合 格 的 namespace 和 class 一 定 是 以 .php 
结尾 的 


7. verdor name , namespaces , class 名 可 以 由 大 小 写字 母 组 合 而 成 
(大 小 写 敏 感 的 ) 
具体 规则 可 能 有 些 让 人 蛙 ， 我 们 从 头 讲 一 下 。 


我 们 先 来 看 PSR0 标 准 大 致 内 容 ， 第 1、2、3、7 条 对 命名 空间 的 名 字 做 出 
了 限制 ， 第 4、5 条 对 命名 空间 和 文件 目录 的 映射 关系 做 出 了 限制 ， 第 6 条 是 文件 后 
AA o 


前 面 我 们 说 过 ，PSR 标 准 是 如 何 规范 命名 空间 和 所 在 文件 目录 之 间 的 映 
射 关 系 ? 是 通过 限制 命名 空间 的 名 字 、 所 在 文件 目录 的 位 置 和 两 者 映射 关系 。 
那么 我 们 可 能 就 要 问 了 ， 哪 里 限制 了 文件 所 在 目录 的 位 置 了 呢 ? 其 实 答案 
就 是 : 
限制 命名 空间 名 字 + 限制 命名 空间 名 字 和 与 文件 目录 映射 = 限制 文件 目录 


好 了 ， 我 们 先 想 一 想 ， 对 于 一 个 具体 程序 来 说 ， 如 果 它 想 要 支持 PSR0 标 
准 , 它 需 要 做 什么 调整 呢 ? 


1. 首先 ， 程 序 必 须 定 义 一 个 符合 PSR0 标 准 第 4、5 条 的 映射 函数 ， 然 后 把 这 
个 函数 注册 到 spl_register() 中 : 

2. 其 次 ， 定 义 一 个 新 的 命名 空间 时 ， 命 名 空间 的 名 字 和 所 在 文件 的 目录 位 置 
必须 符合 第 1、2、3、7 条 。 
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一 般 为 了 代码 维护 方便 ， 我 们 会 在 一 个 文件 只 定义 一 个 命名 空间 。 


好 了 ， 我 们 有 了 符合 PSR0 的 命名 空间 的 名 字 ， 通 过 符合 PSR0 标 准 的 映射 关 
系 就 可 以 得 到 符合 PSR0 标 准 的 文件 目录 地 址 ， 如 果 我 们 按照 PSR0 标 准 正 确 存放 文 
件 ， 就 可 以 顺利 require 该 文件 了 ， 我 们 就 可 以 使 用 该 命名 空间 啦 ， 是 不 是 很 神奇 
呢 ? 


接 下 来 ， 我 们 详细 地 来 看 看 PSR0 标 准 到 底 规范 了 什么 呢 ? 


我 们 以 laravel 中 第 三 方 库 Symfony 其 中 一 个 命 
i] /Symfony/Core/Request 为 例 ， 讲 一 讲 上 面 PSR0 标 准 。 


1. 一 个 完全 合格 的 namespace 和 class 必 须 符 合 这 样 的 结构 : «vendor 


Name>[<Namespace>]*<Class Name» 


上 面 所 展示 的 /Symfony 就 是 Vendor Name， 也 就 是 第 三 方 库 的 名 字 ，/Core 是 
Namespace 名 字 ， 一 般 是 我 们 命名 空间 的 一 些 属性 信息 (例如 request 是 Symfony 的 
核心 功能 ) ; 最 后 Request 就 是 我 们 命名 空间 的 名 字 ， 这 个 标准 规范 就 是 让 人 看 到 命 
名 空间 的 来 源 、 功 能 非常 明朗 ， 有 利于 代码 的 维护 。 


2 . 每 个 hamespace 必 须 有 一 个 顶层 的 namespace ("Vendor Name" 提 供 者 名 


也 就 是 说 每 个 命名 空间 都 要 有 一 个 类 似 于 /Symfony 的 顶级 命名 空间 ， 为 什么 要 
有 这 种 规则 呢 ? 因为 PSRO 标 准 只 负责 顶级 命名 空间 之 后 的 映射 关系 ， 也 就 
是 /Symfony/Core/Request 这 一 部 分 ， 关 于 /Symfony 应 该 关联 到 哪个 目录 ， 那 就 是 
用 户 或 者 框架 自己 定义 的 了 。 所 谓 的 顶层 的 namespace， 就 是 自 定 义 了 映射 关系 的 
命名 空间 ， 一 般 就 是 提供 者 名 字 (第 三 方 库 的 名 字 ) 。 换 句 话 说 顶级 命名 空间 是 自 
动 加 载 的 基础 。 为 什么 标准 要 这 么 设置 呢 ? 原因 很 简单 ， 如 果 有 个 命名 空间 
是 /Symfony/Core/Transport/Request， 还 有 个 命名 空间 
是 /Symfony/Core/Transport/Request1, 如 果 没 有 顶级 命名 空间 ， 我 们 就 得 写 两 个 路 
径 和 这 两 个 命名 空间 相对 应 ， 如 果 再 有 Request2、Request3 呢 。 有 了 顶层 命名 空 
间 /Symfony， 那 我 们 就 仅仅 需要 一 个 目录 对 应 即 可 ， 剩 下 的 就 利用 PSR 标 准 去 解析 
就 行 了 。 


3. 每 个 namespace 可 以 有 多 个 子 namespace 


这 个 很 简单 ，Request 可 以 定义 成 /Symfony/Core/Request， 也 可 以 定义 
成 /Symfony/Core/Transport/Request，/Core 这 个 命名 空间 下 面 可 以 有 很 多 子 命名 
空间 ， 放 多 少 层 命名 空间 都 是 自己 定义 。 


4. 当 从 文件 系统 中 加 载 时 ， 每 个 hamespace 的 分 隔 符 (/) 要 转换 成 
DIRECTORY_SEPARATOR( 操 作 系 统 路 径 分 隔 符 ) 


现在 我 们 终于 来 到 了 映射 规范 了 。 命 名 空间 的 /符号 要 转 为 路 径 分隔 符 ， 也 就 是 
说 要 把 /Symfony/Core/Request 这 个 命名 空间 转 为 \Symfony\Core\Request 这 样 的 目 
录 结 构 。 


5. 在 类 名 中 ， 每 个 下 划 线 符号 要 转换 成 DIRECTORYSEPARATOR( 操 作 系 统 
路 径 分 隔 符 )。 在 namespace 中 ， 下 划 线 \ 符 号 是 没有 (特殊 ) 意义 的 。 


这 句 话 的 意思 就 是 说 ， 如 果 我 们 的 命名 空间 是 /Symfony/Core/Request a > 7f 
么 我 们 就 应 该 把 它 映射 到 \Symfony\Core\Request\a 这 样 的 目录 。 为 什么 会 有 这 种 
规定 呢 ? 这 是 因为 PHP5 之 前 并 没有 命名 空间 ， 程 序 员 只 能 把 名 字 起 成 
Symfony Core Request a 这 样 ，PSR0 的 这 条 规定 就 是 为 了 兼容 这 种 情况 。 


利 下 两 个 很 简单 就 不 说 了 。 


有 这 样 的 命名 空间 命名 规则 和 了 映射 标准 ， 我 们 就 可 以 推理 出 我 们 应 该 把 命名 空 
间 所 在 的 文件 该 放 在 哪里 了 。 依 日 以 Symfony/Core/Request 为 例 ， 它 的 目录 
7/path/to/project/vendor/Symfony/Core/Request.php > X ¥/path/to/project = 1% 5 
目 在 磁盘 的 位 置 ，/path/to/project/lvendor 是 项 目 用 的 所 有 第 三 方 库 所 在 目 
录 。/path/to/project/vendor/Symfony 就 是 与 顶级 命名 空间 /Symfony 郁 在 对 应 关系 的 
目录 ， 再 往 下 的 文件 目录 就 是 按照 PSR0 标 准 建立 的 : 


/Symfony/Core/Request => /Symfony/Core/Request.php 
一 切 很 完满 了 是 吗 ? 不 ， 还 有 一 些 瑕 疯 : 


1. 我 们 是 否 应 该 还 兼容 没有 命名 空间 的 情况 呢 ? 
2. 按照 PSR0 标 准 ， 命 名 空间 /A/B/C/D/E/F 必 然 对 应 一 个 目录 结 
构 /A/B/C/D/E/F， 这 种 目录 结构 层次 是 不 是 太 深 了 ? 


PSR4 标 准 





2013 年 底 ， 新 出 了 第 5 个 规范 一 一 PSR-4。 


PSR-4 规 范 了 如 何 指定 文件 路 径 从 而 自动 加 载 类 定义 ， 同 时 规范 了 自动 加 载 文 
件 的 位 置 。 这 个 年 一 看 和 PSR-0 重 复 了 ， 实 际 上 ， 在 功能 上 确实 有 所 重复 。 区 别 在 
于 PSR-4 的 规范 比较 干净 ， 去 除了 兼容 PHP 5.3 以 前 版 本 的 内 容 ， 有 一 点 PSR-0 升 
级 版 的 感觉 。 当 然 ，PSR-4 也 不 是 要 完全 替代 PSR-0， 而 是 在 必要 的 时 候补 充 PSR- 
0- 当然 ， 如 果 你 愿意 ，PSR-4 也 可 以 替代 PSR-0。PSR-4 可 以 和 包括 PSR-0 在 内 
的 其 他 自动 加 载 机 制 共 同 使 用 。 


PSR4 标 准 与 PSR0 标 准 的 区 别 : 


1. 在 类 名 中 使 用 下 划 线 没有 任何 特殊 含义 。 
2. 命名 空间 与 文件 目录 的 映射 方法 有 所 调整 。 


对 第 二 项 我 们 详细 解释 一 下 (Composer 自 动 加 载 的 原理 ) : 假如 我 们 有 一 
个 命名 空间 : Foo/class，Foo 是 顶级 命名 空间 ， 其 存在 着 用 户 定义 的 与 目录 的 映射 
KA: 


"Foo/" => "src/" 


按照 PSR0 标 准 ， 了 映射 后 的 文件 目录 是 :src/Foo/class.php， 但 是 按照 PSR4 标 
准 ， 了 映射 后 的 文件 目录 就 会 是 :src/class.php， 为 什么 要 这 么 更 改 呢 ? 原因 就 是 怕 命 
名 空间 太 长 导致 目录 层次 太 深 ， 使 得 命名 空间 和 文件 目录 的 映射 关系 更 加 灵活 。 


再 举 一 个 例子 ,来 源 PSR-4 一 一 新 鲜 出 炉 的 PHP 规 范 : 


PSR-0 风 格 


<?php 
-vendor/ 


-package_name/ 

-src/ 

| -Vendor_Name/ 

| | -Package_Name/ 


| | | | -ClassName.php # Vendor_Name\Package_Name\Clas 
sName 
| | | -tests/ 
| | | | -Vendor. Name/ 
| | | | | -Package_Name/ 
| | | | | | -ClassNameTest.php # Vendor_Name\Package_Name\Clas 
sName 
PSR-4 风 格 
-vendor/ 


| -vendor_name/ 

| | -package_name/ 

| | | -src/ 

| | | | -ClassName.php # Vendor_Name\Package_Name\ClassName 
| | | -tests/ 

| | | | -ClassNameTest.php # Vendor_Name\Package_Name\ClassNam 
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上 一 篇 文章 中 ， 我 们 讨论 了 PHP 自动 加 载 功 能 ^ PHP 命 名 空间 ^ PSRO/PSR4Js 
准 ， 有 了 这 些 知 识 ， 其 实 我 们 就 可 以 按照 PSR4 标 准 写 出 可 以 自动 加 载 的 程序 

了 。 然 而 我 们 为 什么 要 自己 写 呢 ?尤其 是 有 Composer 这 神 一 样 的 包 管 理 器 的 情 
AT? 


Composer 5) z/ Ja ei PLE 


简介 


Composer 是 PHP 的 一 个 依赖 管理 工具 。 它 允许 你 申明 项 目 所 依赖 的 代码 库 ， 它 
会 在 你 的 项 目 中 为 你 安装 他 们 。 详 细 内 容 可 以 查看 Composer 中 文 网 。 


Composer Composer 将 这 样 为 你 解决 问题 : 


e 你 有 一 个 项 目 依 赖 于 若干 个 库 。 

e 其 中 一 些 库 依赖 于 其 他 库 。 

e 你 声明 你 所 依赖 的 东西 。 

e Composer 会 找 出 哪个 版 本 的 包 需 要 安装 ， 并 安装 它们 (将 它们 下 载 到 你 
的 项 目 中 ) o 


例如 ， 你 正在 创建 一 个 项 目 ， 你 需要 一 个 库 来 做 日 志 记 录 。 你 决定 使 用 monolog 
o 为 了 将 它 添加 到 你 的 项 目 中 ， 你 所 需要 做 的 就 是 创建 一 个 composer.json 文 
牛 ， 其 中 描述 了 项 目的 依赖 关系 。 


"require": { 
"monolog/monolog^: *1:2-** 


然后 我 们 只 要 在 项 目 里 面 直接 use MonologNLogger 即 可 ， 和 神奇 吧 | 


fa) 897% * Composer 帮助 我 们 下 载 好 了 符合 PSR9/PSR4 标 准 的 第 三 方 库 ， 并 把 
文件 放 在 相应 位 置 ; 帮 有 我 们 写 了 ”autoload() 函数 ， 注 册 到 了 
spl register() 子 数 ， 当 我 们 想 用 第 三 方 库 的 时 候 直接 使 用 命名 空间 即 可 。 


那么 当 我 们 想 要 写 自 己 的 命名 空间 的 时 候 ， 该 怎么 办 呢 ? 很 简单 ， 我 们 只 要 按照 
PSR4 标 准 命名 我 们 的 命名 空间 ， 放 置 我 们 的 文件 ， 然 后 在 composer 里 面 写 好 顶 
级 域名 与 具体 目录 的 映射 ， 就 可 以 享用 composer 的 便利 了 。 


当然 如 果 有 一 个 非常 棒 的 框架 ， 我 们 会 惊喜 地 发 现 ， 在 composer 里 面 写 顶级 域名 
映射 这 事 我 们 也 不 用 做 了 ， 框 架 已 经 帮 我 们 写 好 了 顶级 域名 映射 了 ， 我 们 只 需要 在 
框架 里 面 新 建文 件 ， 在 新 建 的 文件 中 写 好 命名 空间 ， 就 可 以 在 任何 地 方 use 我 们 的 
命名 空间 了 。 


下 面 我 们 就 以 Laravel 框架 为 例 ， 讲 一 讲 composer 是 如 何 实现 PSR9/PSR4 标 准 
的 自动 加 载 功 能 。 


Composer 自 动 加 载 文件 


首先 ， 我 们 先 大 致 了 解 一 下 Composer 自 动 加 载 所 用 到 的 源 文件 。 


1. autoload real.php: 自动 加 载 功 能 的 引导 类 。 
o 任务 是 composer 加 载 类 的 初始 化 (顶级 命名 空间 与 文件 路 径 映射 初始 
化 ) 和 注册 (spl_autoload register())。 
2. ClassLoader.php: composer 加 载 类 。 
o Composer 自 动 加 载 功 能 的 核心 类 。 
3. autoload static.php: 顶级 命名 空间 初始 化 类 ， 
o 用 于 给 核心 类 初始 化 顶级 命名 空间 。 
4. autoload classmap.php: 自动 加 载 的 最 简单 形式 ， 
o 有 完整 的 命名 空间 和 文件 目录 的 映射 ; 
5. autoload files.php: 用 于 加 载 全 局 函数 的 文件 ， 
o 存放 各 个 全 局 函数 所 在 的 文件 路 径 名 : 
6. autoload_namespaces.php: 符合 PSR0 标 准 的 自动 加 载 文件 ， 
o 存放 着 顶级 命名 空间 与 文件 的 映射 ; 
7. autoload psr4.php: 符合 PSR4 标 准 的 自动 加 载 文件 ， 
o 存放 着 顶级 命名 空间 与 文件 的 映射 ; 


laravel 框 架 下 Composer 的 自动 加 载 源 码 分 析 





laravel 框 架 的 初始 化 是 需要 composer 自 动 加 载 协助 的 ， 所 以 laravel 的 入 口 文 
件 index.php 第 一 句 就 是 利用 composer 来 实现 自动 加 载 功能 。 


<?php 
require _ DIR .'/../bootstrap/autoload.php'; 


咱们 接着 去 看 bootstrap 目录 下 的 autoload.php 


<?php 
define('LARAVEL START', microtime(true)); 


require — DIR .. '/../vendor/autoload.php'; 


再 去 vendor 目录 下 的 autoload.php 


<?php 
require_once _ DIR . '/composer' . '/autoload real.php'; 


return ComposerAutoloaderInit832ea71bfb9a4128da8660baedaac82e: 
:getLoader( ); 


为 什么 框架 要 在 ”bootstrap/autoload.php 转 一 下 ?个 人 理解 ，laravel 这 样 设 
计 有 利于 支持 或 扩展 任意 有 自动 加 载 的 第 三 方 库 。 
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J ° autoload real.php 里 面 就 是 一 个 自动 加 载 功 能 的 引导 类 ， 这 个 类 不 负责 具 
体 功 能 逻辑 ， 只 做 了 两 件 事 : 初始 化 自动 加 载 类 、 注 册 自 动 加 载 类 。 


到 autoload real 这 个 文件 里 面 去 看 ， 发 现 这 个 引导 类 的 名 字 叫 

ComposerAutoloaderlnit832ea71bfb9a4128da8660baedaac82e， 为 什么 要 叫 这 人 么 
古怪 的 名 字 呢 ? 因为 这 是 防止 用 户 自 定义 类 名 跟 这 个 类 重复 冲突 了 ， 所 以 在 类 名 上 
加 了 一 个 hash 值 。 其 实 还 有 一 个 做 法 我 们 更 加 熟悉 ， 那 就 是 不 直接 定义 类 名 ， 而 是 


定义 一 个 命名 空间 。 这 里 为 什么 不 定义 一 个 命名 空间 呢 ? 个 人 理解 : 命名 空间 一 般 
都 是 为 了 复 用 ， 而 这 个 类 只 需要 运行 一 次 即 可 ， 以 后 也 不 会 用 得 到 ， 用 hash 值 更 加 
合适 。 
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4& vendor 目录 下 的 autoload.php 文件 中 我 们 可 以 看 出 ， 程 序 主 要 调用 了 引导 
类 的 静态 方法 getLoader() ， 我 们 接着 看 看 这 个 函数 。 


<?php 
public static function getLoader() 


( 


*ockockckockockocko ko ko ko ko kockck ck kock ck ko ck k kc ck kkokek AA d r5 2 KKK KKK KK KKK KKK ck ko ck ko ck 
/ 经 典 单 例 模 3 i 


if (null !== self::$loader) { 
return self::$loader; 


f/**5k*kkkdkd dk kk k k ke e ke e EKER 3E PE oh hr By AG VS ER BOR RRA KR KKK EK KKK KK 
ES EEE SS // 
spl autoload register( 
array('ComposerAutoloaderInit832ea71bfb9a4128da8660baeda 
ac82e', 'loadClassLoader'), true, true 


); 


self::$loader = $loader = new \Composer\Autoload\ClassLoad 
er(); 


spl_autoload_unregister ( 
array('ComposerAutoloaderInit832ea71bfb9a4128da8660baeda 
ac82e', 'loadClassLoader') 


); 


[J BR RRRRKRER EKER EREKK ERE Fy MAY E oH a RAGS HR RRR RAK ARK KK KKK 


RES VA 


$useStaticLoader = PHP VERSION ID >= 50600 && !defined('HH 
VM VERSION'); 


if ($useStaticLoader) { 
require_once _ DIR .. '/autoload static.php'; 


call user func( 
NComposerNAutoloadNComposerStaticInit832ea71bfb9a4128d 
a8660baedaac82e: :getInitializer($loader ) 


); 


) else { 
$map = require | DIR .. '/autoload namespaces.php'; 
foreach ($map as $namespace => $path) { 
$loader->set($namespace, $path); 


$map = require _DIR . '/autoload psr4.php'; 
foreach ($map as $namespace => $path) { 
$loader->setPsr4($namespace, $path); 


$classMap = require _ DIR . '/autoload classmap.php' 


if ($classMap) { 
$loader ->addClassMap($classMap) ; 


f 5 kk k kk k koe ke ke k ok kk E X IS ME Ah er RAG NS EO ELA SA kA kk kk 


ERKAT 


$loader ->register (true); 


2 
f kk ok ck ck hok koh ok ko k k kk k kk É xhduik4EPSQAQSS*XAA*kk*k*kkxkkk*kkx 


if ($useStaticLoader) { 
$includeFiles = Composer \Autoload\ComposerStaticInit83 
2ea71bfb9a4128da8660baedaac82e::$files; 
) else ( 
$includeFiles = require DIR .. '/autoload files.php' 


foreach ($includeFiles as $fileIdentifier => $file) { 
composerRequire832ea71bfb9a4128da8660baedaac82e($fileI 
dentifier, $file); 
E 


return $loader; 





从 上 面 可 以 看 出 ， 我 把 自动 加 载 引 导 类 分 为 5 个 部 分 。 


第 一 部 分 很 简单 ， 就 是 个 最 经 典 的 单 例 模 式 ， 自 动 加 载 类 只 能 有 一 个 。 


<?php 
if (null !== self::$loader) { 
return self::$loader; 





第 二 部 分 构造 ClassLoader 核 心 类 


二 部 分 new 一 个 自动 加 载 的 核心 类 对 象 。 


W 


<?php 


[RR RRERRREREREKEKKEK KKK K ISA E oh He AG SER EDO A Ak kh kk kk, 


spl autoload register( 
array('ComposerAutoloaderInit832ea71bfb9a4128da8660baedaac82 
e', 'loadClassLoader'), true, true 


); 


self::$loader = $loader = new \Composer\Autoload\ClassLoader ( ) 


spl autoload unregister( 
array('ComposerAutoloaderInit832ea71bfb9a4128da8660baedaac82 
e', 'loadClassLoader') 


); 
| 


loadClassLoader() 函数 : 


<?php 
public static function loadClassLoader($class) 


X 
if ('Composer\Autoload\ClassLoader' === $class) { 


require — DIR |. '/ClassLoader.php'; 


从 程序 里 面 我 们 可 以 看 出 ，composer 先 向 PHP 自动 加 载 机 制 注 册 了 一 个 函数 ， 这 
个 函数 require 了 ClassLoader 文件 。 成 功 new 出 该 文件 中 核心 类 ClassLoader() 
后 ， 又 销毁 了 该 函数 。 


为 什么 不 直接 require， 而 要 这 么 麻烦 ?原因 就 是 怕 有 的 用 户 也 定义 了 个 
\Composer\Autoload\ClassLoader 命名 空间 ， 导 致 自动 加 载 错 误 文件 。 那 为 什 
么 不 跟 引 导 类 一 样 用 个 hash BW? 因为 这 个 类 是 可 以 复 用 的 ， 框 架 允 许 用 户 使 用 这 


第 三 部 分 一 -初始 化 核心 类 对 象 


<?php 


5 h = PS Sg OS ee ee 
[RR d eek e eek RK RHE KEK KK BILLY ÉL oh Ja HAG NS KAY IN It eee KR KK 
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$useStaticLoader = PHP VERSION ID >= 50600 && !defined('HHVM_V 
ERSION'); 

if ($useStaticLoader) { 


require_once _ DIR . '/autoload static.php'; 


call_user_func( 
NComposerNAutoloadNComposerStaticInit832ea71bfb9a4128da86 
60baedaac82e::getInitializer($1loader) 
); 
} else { 
$map = require _DIR__ . '/autoload namespaces.php'; 
foreach ($map as $namespace => $path) { 
$loader->set($namespace, $path); 


$map = require _DIR . '/autoload psr4.php'; 
foreach ($map as $namespace => $path) { 
$loader->setPsr4($namespace, $path); 


$classMap = require _DIR_ . '/autoload classmap.php'; 
if ($classMap) { 
$loader ->addClassMap($classMap) ; 


这 一 部 分 就 是 对 自动 加 载 类 的 初始 化 ， 主 要 是 给 自动 加 载 核心 类 初始 化 顶级 命名 空 
间 映 射 。 


初始 化 的 方法 有 两 种 : 


1. 使 用 autoload static 进 行 静态 初始 化 ; 
2. 调用 核心 类 接口 初始 化 。 


autoload_statica? & 77 46 1 


静态 初始 化 只 支持 PHP5.6 以 上 版 本 并 且 不 支持 HHVM 虚拟 机 。 我 们 深入 
autoload_static.php 这 个 文件 发 现 这 个 文件 定义 了 一 个 用 于 静态 初始 化 的 

类 ， 名 字 叫 ComposerStaticInit832ea71bfb9a4128da8660baedaac82e ， 仍 然 
为 了 避免 冲突 加 了 hash 值 。 这 个 类 很 简单 : 


<?php 
class ComposerStaticInit832ea71bfb9a4128da8660baedaac82e( 
public static $files = array(...); 
public static $prefixLengthsPsr4 = array(...); 
public static $prefixDirsPsr4 = array(...); 
public static $prefixesPsrO = array(...); 
public static $classMap = array (...); 


public static function getInitializer(ClassLoader $loader ) 
{ 
return \Closure::bind(function () use ($loader) { 
$loader ->prefixLengthsPsr4 
= ComposerStaticInit832ea71bfb9a4128da 
8660baedaac82e: :$prefixLengthsPsr4; 


$loader ->prefixDirsPsr4 
= ComposerStaticInit832ea71bfb9a4128da 
8660baedaac82e: :$prefixDirsPsr4; 


$1oader-»prefixesPsrO 
- ComposerStaticInit832ea71bfb9a4128da 
8660baedaac82e: : $5prefixesPsr0; 


$loader ->classMap 
= ComposerStaticInit832ea71bfb9a4128da 
8660baedaac82e: :$classMap; 


}, null, ClassLoader::class); 


这 个 静态 初始 化 类 的 核心 就 是 getInitializer() 函数 ， 它 将 自己 类 中 的 顶级 命 
名 空间 映射 给 了 ClassLoader 类 。 值 得 注意 的 是 这 个 函数 返回 的 是 一 个 匿名 防 数 ， 
为 什么 呢 ?原因 就 是 ClassLoader 类 中 的 prefixLengthsPsr4 


DHD Camnncar 25 dd AVG £i ZW He 
PHP Composer ea 6 ARMA AT T] 





* prefixDirsPsr4 等 等 方法 都 是 private 的 。。。 普 通 的 函数 没 办 法 给 类 的 
private 成 员 变量 赋值 。 利 用 匿名 函数 的 绑 定 功能 就 可 以 将 把 匿名 函数 转 为 
ClassLoader 类 4 9X 5i EZ e 


关于 匿名 函数 的 绑 定 功能 。 


接 下 来 就 是 顶级 命名 空间 初始 化 的 关键 了 。 
最 简单 的 classMap: 


<?php 
public static $classMap = array ( 
'App\\Console\\Kernel' 
=> _ DIR - 4.7... = "Yapp/Consote/KerneL.php^, 


"App\\Exceptions\\Handler' 
=> — DIR. . 'Z..7..* « “Sapp7Exceptions/Handler.p 
hp', 


'AppNNHttpNNControllersNNAuthNNForgotPasswordController ' 
=> DIR . '/../.." . */app7Http/Controllers/Aut 
h/ForgotPasswordController.php', 


'AppNNHttpNNControllersNNAuthNNLoginController' 
=@ DIR LE = 'Zapp7Hetp/ Controllers/Aut 
h/LoginController.php', 


'AppNNHttpNNControllersNNAuthNNRegisterController' 
=> DIR .. '/../..' . '/app/Http/Controllers/Aut 
h/RegisterController.php', 


-) 


简单 吧 ， 直 接 命名 空间 全 名 与 目录 的 映射 ， 没 有 顶级 命名 空间 o o o 简单 粗暴 ， 也 
导致 这 个 数组 相当 的 大 。 


PSRO 顶级 命名 空间 映射 : 


NO 
NS 





PHP Composer 


初始 化 源码 分 析 


<?php 
public static $prefixesPsrO = array ( 
'P' => array ( 
'ProphecyNN' => array ( 
© => DIR .. '/..' . '/phpspec/prophecy/src', 
), 


'Parsedown' => array ( 
© => DIR_ . '/..' . '/erusev/parsedown', 
), 
), 
'M' => array ( 
'Mockery' => array ( 
0 => DIR .. '/..' . '/mockery/mockery/library', 
), 
), 
'J' => array ( 
'JakubOnderka\\PhpConsoleHighlighter' => array ( 
© => DIR . '/..' . '/jakub-onderka/php-console-h 
ighlighter/src', 
), 
'JakubonderkaNNPhpConsoleColor' => array ( 
© => DIR . '/..' . '/jakub-onderka/php-console-c 
olor/src', 
), 
), 
'D' => array ( 
'DoctrineNNCommonNNInflectorNN' => array ( 
Q-=>>_ [DIR — 2 4..." — */doctraine/intlector/iab™, 
), 
), 
); 


为 了 快速 找到 顶级 命名 空间 ， 我 们 这 里 使 用 命名 空间 第 一 个 字母 作为 前 级 索引 。 这 
个 映射 的 用 法 比较 明显 ， 假 如 我 们 有 Parsedown/example 这 样 的 命名 空间 ， 首 先 通 
过 首 字母 P， 找 到 
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<?php 
'P' => array ( 
'ProphecyNN' => array ( 
© => DIR .. '/..' . '/phpspec/prophecy/src', 
), 


'Parsedown' => array ( 
0 => DIR .. '/..' . '/erusev/parsedown', 
), 
), 


这 个 数组 ， 然 后 我 们 就 会 遍历 这 个 数组 来 和 Parsedown/example MRX » RIA 
一 个 Prophecy 不 符合 ， 第 二 个 Parsedown 符合 ， 然 后 得 到 了 映射 目录 : (映射 目 
录 可 能 不 止 一 个 ) 


<?php 
array (0 => — DIR . '/..' . '/erusev/parsedown', ) 
我 们 会 接着 遍历 这 个 数组 ， 尝 试 _DIR_. '/..' 


'/erusev/parsedown/Parsedown/example.php' 是 否 存 在 ， 如 果 不 存在 接着 遍 
历数 组 (这 个 例子 数组 只 有 一 个 元 素 )， 如 果 数 组 遍历 完 都 没有 ， 就 会 加 载 失败 。 


PSR4 标 准 顶 级 命名 空间 映射 数组 : 





PHP Composer 初始 化 源码 分 析 


<?php 
public static $prefixLengthsPsr4 = array( 

'p' => array ( 

'phpDocumentorNNReflectionNN' => 25, 
), 

'S' => array ( 
'Symfony\\Polyfill\\Mbstring\\' => 26, 
'SymfonyNNComponentNNYam1NN'! => 23, 
'SymfonyNNComponentNNVarDumperNN' => 28, 


), 
DE 


public static $prefixDirsPsr4 = array ( 
'phpDocumentorNNReflectionNN' => array ( 


© => DIR .. '/..' . '/phpdocumentor/reflection-common 
pe. 
1 => DIR . '/..' . '/phpdocumentor/type-resolver/src' 
2 => DIR .. '/..' . '/phpdocumentor/reflection-docblo 
ck/sre-^. 
) 
'Symfony\\Polyfill\\Mbstring\\' => array ( 
goce 2S DIR- |] 7 = -/symfony7 polyrill-mbstring, ; 
), 
'Symfony\\Component\\Yaml\\' => array ( 
Q => DIR = ceto 7 symtony7/yaml’. 
), 
-) 


"| 
PSR4 标 准 顶 级 命名 空间 映射 用 了 两 个 数组 ， 第 一 个 和 PSRO 一 样 用 命名 空间 第 一 
个 字母 作为 前 级 索引 ， 然 后 是 顶级 命名 空间 ， 但 是 最 终 并 不 是 文件 路 径 ， 而 是 顶 
级 命名 空间 的 长 度 。 为 什么 呢 ? 因为 前 一 篇 文章 我 们 说 过 ，PSR4 标 准 的 文件 目录 
更 加 灵活 ， 更 加 简洁 。 


PSRO 中 顶级 命名 空间 目录 直接 加 到 命名 空间 前 面 就 可 以 得 到 路 径 


Parsedown/example => _DIR_ . '/..' 


'/erusev/parsedown/Parsed 
own/example. php 


DNN 
i p EE UE ERE UD ERE 


而 PSR4 标 准 却 是 用 顶级 命名 空间 目录 替换 顶级 命名 空间 ， 所 以 获得 顶级 命名 空间 
的 长 度 很 重要 。 


Parsedown/example => _DIR . '/..' 


'/erusev/parsedown/exampl 
e.php 


i WE ECCE E EE 
TITI 


具体 的 用 法 : 假如 我 们 找 Symfony\\Polyfill\\Mbstring\\example 这 个 命名 
空间 ， 和 PSRO 一 样 通过 前 级 索引 和 字符 囊 匹 配 我 们 得 到 了 


<?php 
'Symfony\\Polyfill\\Mbstring\\' => 26, 


这 条 记录 ， 键 是 顶级 命名 空间 ， 值 是 命名 空间 的 长 度 。 拿 到 顶级 命名 空间 后 去 
$prefixDirsPsr4 数 组 获取 它 的 映射 目录 数组 : (注意 映射 目录 可 能 不 止 一 条 ) 


<?php 
'Symfony\\Polyfill\\Mbstring\\' => array (人 


goo UD IR T '/symfony/polyfill-mbstring' 


~ 


) 
| 
然后 我 们 就 可 以 将 命名 空间 symfony\\Polyfill\\Mbstring\\example 前 26 个 


字符 替换 成 目录 DIR. '/..' 


'/symfony/polyfill-mbstring ， 我 们 
就 得 到 了 Ree 


'/symfony/polyfill- 
mbstring/example.php ， 先 验证 磁盘 上 这 个 文件 是 否 存 在 ， 如 果 不 存在 接着 遍 
历 。 如 果 遍 历 后 没有 找到 ， 则 加 载 失 败 。 


自动 加 载 核 心 类 ClassLoader 的 静态 初始 化 完成 1 | | 


ClassLoader 接 口 初始 化 


如 果 PHP 版 本 低 于 5.6 或 者 使 用 HHVM 虚拟 机 环境 ， 那 么 就 要 使 用 核心 类 的 接口 进 
行 初 始 化 。 


<?php 
//PSRO 标 准 
$map = require _DIR_ . '/autoload namespaces.php'; 


foreach ($map as $namespace => $path) { 
$loader->set($namespace, $path); 


//PSR4 标 准 
$map = require _DIR__ . '/autoload psr4.php'; 


foreach ($map as $namespace => $path) { 
$loader->setPsr4($namespace, $path); 


$classMap = require _DIR__ . '/autoload classmap.php'; 
if ($classMap) { 
$loader ->addClassMap($classMap) ; 


PSR0 标 准 


autoload_namespaces : 


xx 11 SE T 7 lc 
了 初始 化 产 码 分 析 





PHP Composer 


<?php 
return array( 
"Prophecy\\' 


=> array($vendorDir . 


'Parsedown' 


=> array($vendorDir . 


'Mockery' 


-» array($vendorDir . 


'/phpspec/prophecy/src'), 


'/erusev/parsedown' ), 


'/mockery/mockery/library'), 


' JakubonderkaNNPhpConsoleHighlighter ' 


=> array($vendorDir . 


ghlighter/src'), 


'/jakub-onderka/php-console-hi 


'JakubOnderka\\PhpConsoleColor ' 


=> array($vendorDir . 


OrASne i 


'/jakub-onderka/php-console-co 


"Doctrine\\Common\\Inflector\\' 


=> array($vendorDir . 


); 


'/doctrine/inflector/lib'), 


$this->fallbackDirsPsr® = (array) $paths; 


$this->prefixesPsrO[$prefix[O]][$prefix] = (array) $ 


PSR0 标 准 的 初始 化 接口 : 
<?php 
public function set($prefix, $paths) 
{ 
if (!$prefix) { 
) else { 
paths; 
} 
} 
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很 简单 ，PSR0 标 准 取出 命名 空间 的 第 一 个 字母 作为 索引 ， 一 个 索引 对 应 多 个 顶级 
命名 空间 ， 一 个 顶级 命名 空间 对 应 多 个 目录 路 径 ， 具 体形 式 可 以 查看 上 面 我 们 讲 的 
autoload static 的 $prefixesPsrO 。 如 果 没 有 顶级 命名 空间 ， 就 只 存储 一 个 路 径 

名 ， 以 便 在 后 面 尝 试 加 载 。 


PSR4 标 准 
autoload_psr4 


<?php 
return array( 
'XdgBaseDir\\' 
=> array($vendorDir . '/dnoegel/php-xdg-base-dir/src'), 


'Webmozart\\Assert\\' 
=> array($vendorDir . '/webmozart/assert/src'), 


'TijsVerkoyen\\CssToInlineStyles\\ ' 


=> array($vendorDir . '/tijsverkoyen/css-to-inline-style 
S/SE) 
TES ESANS 
=> array($baseDir . '/tests'), 


'Symfony\\Polyfill\\Mbstring\\' 
=> array($vendorDir . '/symfony/polyfill-mbstring'), 


PSR4 标 准 的 初始 化 接口 : 


<?php 
public function setPsr4($prefix, $paths) 
{ 
if (!$prefix) { 
$this->fallbackDirsPsr4 = (array) $paths; 


} else { 
$length = strlen($prefix); 
if ('\\' !== $prefix[$length = 1]) { 


throw new \InvalidArgumentException( 
"A non-empty PSR-4 prefix must end with a name 
space separator." 


); 


} 
$this->prefixLengthsPsr4[$prefix[0]][$prefix] = $len 
gth; 
$this->prefixDirsPsr4[$prefix] = (array) $paths; 
} 
} 


PSR4 初 始 化 接口 也 很 简单 。 如 果 没 有 顶级 命名 空间 ， 就 直接 保存 目录 。 如 果 有 命 
名 空间 的 话 ， 要 保证 顶级 命名 空间 最 后 是 N RETIRE 


( WHA -> 顶级 命名 空间 ， 顶 级 命名 空间 -> 顶级 命名 空间 长 度 ) 
( 顶级 命名 空间 -> 目录 ) 


这 两 个 映射 数组 。 具 体形 式 可 以 查看 上 面 我 们 讲 的 autoload static 的 
prefixLengthsPsr4 ` $prefixDirsPsr4 ° 


傻瓜 式 命名 空间 映射 


autoload_classmap : 


<?php 
public static $classMap = array ( 
"App\\Console\\Kernel' 
=> DIR = “7.2/2. = “/app/Console/Kernel. php”, 


"App\\Exceptions\\Handler ' 


=> DIR  . '/../..' . '/app/Exceptions/Handler.php', 
) 
addClassMap: 
«?php 
public function addClassMap(array $classMap) 
{ 
if ($this->classMap) { 
$this->classMap = array_merge($this->classMap, $clas 
sMap); 
) else { 
$this->classMap = $classMap; 
} 
} 


这 个 最 简单 ， 就 是 整个 命名 空间 与 目录 之 间 的 映射 。 


结语 


和 运行 放 到 下 一 篇 文章 了 。 我 们 回顾 一 下 ， 这 篇 文章 主要 讲 了 : 


工 . 框 架 如 何 局 动 Composer 自 动 加 载 ; 
2.composer 自 动 加 载 分 为 5 部 分 ; 


其 实说 是 5 部 分 ， 旦 正 重要 的 就 两 部 分 一 一 初始 化 与 注册 。 初 始 化 负责 顶层 命名 空 
间 的 目录 映射 ， 注 册 负责 实现 顶层 以 下 的 命名 空间 映射 规则 。 


PHP Composer—— 初始 化 源码 分 析 


Written with StackEdit. 
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上 一 篇 文章 我 们 讲 到 了 Composer 自 动 加 载 功能 的 启动 与 初始 化 ， 经 过 启动 与 
初始 化 ， 自 动 加 载 核心 类 对 象 已 经 获得 了 顶级 命名 空间 与 相应 目录 的 映射 ， 换 和 句 话 
说 ， 如 果 有 命名 空间 'App\Console\Kernel， 我 们 已 经 知道 了 App\ 对 应 的 目录 ， 接 下 
来 我 们 就 要 解决 下 面 的 就 是 \Console\Kernel 这 一 段 。 


Composer 目 动 加 载 源码 分 析 一 一 注册 


我 们 先 回顾 一 下 自动 加 载 引 寻 类 : 


”php 
public static function getLoader() 


{ 


[RRR R KERR EKER ERE KEKE RHEE KEKE LZ UD E RE RRR RR RRR RR RRR RK KR RK / 


if (null !== self::$loader) { 
return self: :$loader; 


人 
nA 

spl autoload register(array('ComposerAutoloaderInit 

832ea71bfb9a4128da8660baedaac82e', 'loadClassLoader'), true, 
true); 


self::$1oader = $loader = new \Composer\Autoload\ClassLoader 


©; 


spl autoload unregister(array('ComposerAutoloaderInit 
832ea71bfb9a4128da8660baedaac82e', 'loadClassLoader')); 


J RRR OK de koe ee ke HH HK HK 3n Je A, EL] Jja BY AH NS Jp pr eee ee 


EIUS te // 


2): 


Er 


$useStaticLoader - PHP VERSION ID »- 50600 && 
! defined('HHVM VERSION'); 


if ($useStaticLoader) { 
require_once DIR .. '/autoload static.php'; 


call user func(NComposerNAutoloadNComposerStaticlInit 
832ea71bfb9a4128da8660baedaac82e::getInitializer($1loader 


) else { 
$map = require _ DIR .. '/autoload namespaces.php'; 
foreach ($map as $namespace => $path) { 
$loader->set($namespace, $path); 


$map = require _ DIR . '/autoload psr4.php'; 
foreach ($map as $namespace => $path) { 
$loader->setPsr4($namespace, $path); 


$classMap = require |DIR .. '/autoload classmap.php'; 
if ($classMap) { 
$loader->addClassMap($classMap) ; 


[BER RRRKRKERKEKKRK ee e KK RK IE A E AH a HAG SR eS kk kk 


$loader->register(true); 


[RRR RR RR KR RR IK EL oH Jo BRAS By Shy Fi ORR ORO RO RR 
if ($useStaticLoader) { 
$includeFiles = ComposerNAutoloadNComposerStaticInit 
832ea71bfb9a4128da8660baedaac82e: :$files; 
} else { 
$includeFiles = require _ DIR . '/autoload files.php'; 


foreach ($includeFiles as $fileIdentifier => $file) { 


composerRequire 
832ea71bfb9a4128da8660baedaac82e($fileldentifier, $file) 


return $loader; 


现在 我 们 开始 引导 类 的 第 四 部 分 : 注册 自动 加 载 核心 类 对 象 。 我 们 来 看 看 核心 类 的 
register() 2x : 


`` php 
public function register($prepend = false) 


{ 


spl_autoload_register(array($this, 'loadClass'), true, $prep 
end); 
} 


简单 到 爆炸 啊 ! 一 行 代码 实现 自动 加 载 有 木 有 ! 其 实 奥秘 都 在 自动 加 载 核心 类 
ClassLoader 的 loadClass() 函 数 上 ， 这 个 函数 负责 按照 PSR 标 准将 顶层 命名 空间 以 
下 的 内 容 转 为 对 应 的 目录 ， 也 就 是 上 面 所 说 的 将 'App\Console\Kernel 

中 'Console\Kernel 这 mais 目录 ， 至 于 怎么 转 的 我 们 在 下 面 “Composer 自 动 加 载 
源码 分 KS X ClassLoader loadClass() & 2t 1 HF] PHP SPL 中 的 
spl autoload register() 里 面 去 ， 这 个 有 函数 的 来 龙 去 脉 我 们 之 前 文章 讲 过 。 这 样 ， 每 
当 PHP 遇 到 一 个 不 认识 的 命名 空间 的 时 候 ，PHP 会 自动 调用 注册 到 

spl autoload register 里 面 的 函数 堆栈 ， 运 行 其 中 的 每 个 函数 ， 直 到 找到 命名 空间 
对 应 的 文件 。 


~ /yy 














Composer 目 动 加 载 源 码 分 析 一 一 全 局 函数 的 
自动 加 载 


Composer 不 止 可 以 自动 加 载 命 名 空间 ， 还 可 以 加 载 全 局 函数 。 怎 么 实现 的 


呢 ? 很 简单 ， 把 全 局 函数 写 到 特定 的 文件 里 面 去 ， 在 程序 运行 前 挨个 require 就 行 
了 。 这 个 就 是 composer 自 动 加 载 的 第 五 步 ， 加载 全 局 函数 。 


`` php 
if ($useStaticLoader) ( 


$includeFiles = Composer\Autoload\ComposerStaticInit832e 
a7ibfb9a4128da8660baedaac82e: :$files; 
) else { 


$includeFiles = require _ DIR . '/autoload files.php'; 
j 
foreach ($includeFiles as $fileIdentifier => $file) ( 


composerRequire832ea71bfb9a4128da8660baedaac82e($filelde 
ntifier, $file); 


} 


d 全 局 函数 自动 加 载 也 分 为 两 种 : 静态 初始 化 和 普通 初始 
静态 加 载 只 支持 PHP5.6 以 上 并 且 不 支持 HHVM © 


静态 初始 化 : 


ComposersStaticlnit832ea7 1bfb9a4128da8660baedaac82e::$files : 


' php 
public static $files = array ( 
'Oe6d7bf4a5811bfa5cf40c5ccd6fae6a' => 3». DIR .. '/..' '/sy 
mfony/polyfill-mbstring/bootstrap.php', 
'667aeda72477189d0494fecd327c3641' => _DIR_ . '/..' '/sy 
mfony/var -dumper/Resources/functions/dump.php', 
); 
D PC ELRA BRET o IE AT BERLE > it 3 — hash T ft 


AR, 2 这 个 我 们 一 会 儿 讲 ， 我 们 这 里 先 了 解 一 下 这 个 数组 的 结构 。 


普通 初始 化 


autoload_files: 


`` php 
$vendorDir = dirname(dirname(__FILE__))j; 
$baseDir = dirname($vendorDir); 


return array( 
'Oe6d7bf4a5811bfa5cf40c5ccd6fae6a' => $vendorDir . '/symfony/pol 
yfill-mbstring/bootstrap.php', 


'667aeda72477189d0494fecd327c3641' => $vendorDir . '/symfony/var 
-dumper/Resources/functions/dump.php', 


): 


其 实 跟 静 态 初始 化 区 别 不 大 。 


加 载 全 局 函数 


`` php 
class ComposerAutoloaderInit832ea71bfb9a4128da8660baedaac82e{ 
public static function getLoader(){ 


foreach ($includeFiles as $fileIdentifier => $file) { 
composerRequire832ea71bfb9a4128da8660baedaac82e($fileIde 
ntifier, $file); 
} 


function composerRequire832ea71bfb9a4128da8660baedaac82e($fileId 
entifier, $file) 


{ 
if (empty(N$GLOBALS[' composer autoload files'][*N$filelIdent 
ifier])) { 
require $file; 
$GLOBALS[' composer autoload files'][$fileIdentifier] = 
true; 
} 


这 一 段 很 有 讲究 ， 第 一 个 问题 : 为 什么 自动 加 载 引 导 类 的 getLoader() 函 数 不 直 
接 require $includeFiles 里 面 的 每 个 文件 名 ， 而 要 用 类 外 面 的 函数 
composerRequire832ea71bfb9a4128da8660baedaac82e0 ? (顺便 说 下 这 个 函数 名 
hash 仍 然 为 了 避免 和 用 户 定义 函数 冲突 ) 因 为 怕 有 人 在 全 局 函数 所 在 的 文件 写 $this 
或 者 self 。 假如 $includeFiles 有 个 app/helper.php 文 件 ， 这 个 helper.php 文 件 的 
函数 外 有 一 行 代码 : $this->foo() > 4 4] 4 KH getLoader() £X 64% 
require($file)， 那 么 引导 类 就 会 运行 这 名 代码 ， 调 用 自己 的 foo() 函 数 ， 这 显然 是 错 
的 。 事 实 上 helper.php 就 不 应 该 出 现 $this 或 self 这 样 的 代码 ， 这 样 写 一 般 都 是 用 户 写 
错 了 的 ， 一 旦 这 样 的 事情 发 生 ， 第 一 种 情况 : 引导 类 恰好 有 foo() 函 数 ， 那 么 就 会 莫 
名 其 妙 执 行 了 引导 类 的 foo(); 第 二 种 情况 : 引导 类 没有 foo() 骂 数 ， 但 是 却 甩 出 来 引导 
类 没有 foo() 方 法 这 样 的 错误 提示 ， 用 户 不 知道 自己 哪里 错 了 。 把 require 语 句 放 到 引 
导 类 的 外 面 ， 遇 到 $this 或 者 self， 程 序 就 会 告诉 用 户 根 本 没有 类 ，gthis 或 self 无 效 ， 


错误 信息 更 加 明朗 。 第 二 个 问题 ， 为 什么 要 用 hash 作 为 $fileldentifier， 上 面 的 
代码 明显 可 以 看 出 来 这 个 变量 是 用 来 控制 全 局 部 数 只 被 require 一 次 的 ， 那 为 什么 不 
用 require_once 呢 ?事实 上 regquire_once 比 require 效 率 低 很 多 ， 使 用 全 局 变量 
$GLOBALS 这 样 控制 加 载 会 更 快 。 还 有 一 个 原因 我 猜测 应 该 是 require_once 对 相对 
路 径 的 支持 并 不 理想 ， 所 以 composer 尽 量 少 用 require_once。 


= 
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我 们 终于 来 到 了 核心 的 核心 一 “composer 自 动 加 载 的 真相 ， 命 名 空间 如 何 通过 
composer 转 为 对 应 目录 文件 的 奥秘 就 在 这 一 章 。 前 面 说 过 ，ClassLoader 的 
register() % 24 loadClass() & žk 72 Ht 2] PHP #4 SPL HAE P > 4 4 PHP] RA 
识 的 命名 空间 时 就 会 调用 函数 堆栈 的 每 个 函数 ， 直 到 加 载 命名 空间 成 功 。 所 以 
loadClass() 函 数 就 是 自动 加 载 的 关键 T ° loadClass(): 


"php 
public function loadClass($class) 
{ 
if ($file = $this->findFile($class)) { 
includeFile($file); 
return true; 
} 
} 


public function findFile($class) 


// work around for PHP 5.3.0 - 5.3.2 https://bugs.php.net/50 
731 
if ('\\' == $class[0]) { 
$class = substr($class, 1); 


// class map lookup 
if (isset($this->classMap[$class])) ( 
return $this-»classMap[S$class]; 


if ($this->classMapAuthoritative) { 
return false; 


$file = $this->findFilewithExtension($class, '.php'); 


// Search for Hack files if we are running on HHVM 
if ($file === null && defined('HHVM_VERSION')) { 
$file = $this->findFilewithExtension($class, '.hh'); 


} 

if ($file === null) { 
// Remember that this class does not exist. 
return $this->classMap[$class] = false; 

} 


return $file; 


RIIA SlloadClass() > 3:338 A findFile() 4 2k » findFile() H aA "E IH] 5 a 
候 主 要 分 为 两 部 分 : classMap#findFileWithExtension() 44x ° classMap4K fi 4 > 
直接 看 命名 空间 是 否 在 映射 数组 中 即 可 。 麻 烦 的 是 findFileWithExtension() 元 数 ， 这 
个 函数 包含 了 PSR0 和 PSR4 标 准 的 实现 。 还 有 个 值得 我 们 注意 的 是 查找 路 径 成 功 后 
includeFile()45 Z& 3& 7r dn hg Až > JE 75 I ClassLoader5 5 5i ik » 8 E SR E d — 
样 ， 防 止 有 用 户 写 $this 或 self。 还 有 就 是 如 果 命 名 空间 是 以 \ 开 头 的 ， 要 去 掉 \ 然 后 再 
匹配 。 findFileWithExtension : 


' php 
private function findFileWithExtension($class, $ext) 
{ 
// PSR-4 lookup 
$logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) 
. $ext; 
$first = $class[0]; 
if (isset($this->prefixLengthsPsr4[$first])) { 
foreach ($this->prefixLengthsPsr4[$first] as $prefix => 
$length) { 


if (0 === strpos($class, $prefix)) { 
foreach ($this->prefixDirsPsr4[$prefix] as $dir) 


if (file_exists($file = $dir . DIRECTORY_SEP 
ARATOR . substr($10gicalPathPsr4, $length))) { 
return $file; 


// PSR-4 fallback dirs 
foreach ($this->fallbackDirsPsr4 as $dir) { 
if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $lo 
gicalPathPsr4)) { 
return $file; 


// PSR-0 lookup 
if (false !-- $pos = strrpos($class, '\\')) { 
// namespaced class name 
$1ogicalPathPsrO = substr($logicalPathPsr4, 0, $pos + 1) 


. strtr(substr($logicalPathPsr4, $pos + 1), ' ', DIR 
ECTORY SEPARATOR); 
) else { 
// PEAR-like class name 
$logicalPathPsrO = strtr($class, ' ', DIRECTORY SEPARATO 
R) . $ext; 
} 


if (isset($this->prefixesPsrO[$first])) { 
foreach ($this->prefixesPsrO[$first] as $prefix => $dirs 
) {í 
if (0 === strpos($class, $prefix)) { 
foreach ($dirs as $dir) { 
if (file_exists($file = $dir . DIRECTORY_SEP 
ARATOR . $logicalPathPsr0O)) { 
return $file; 


// PSR-0 fallback dirs 
foreach ($this->fallbackDirsPsrO as $dir) { 
if (file_exists($file = $dir . DIRECTORY SEPARATOR . $1o 
gicalPathPsr0O)) { 
return $file; 


// PSR-0 include paths. 
if ($this->useIncludePath && $file = stream resolve include 
path($logicalPathPsrO)) { 
return $file; 


下 面 我 们 通过 举例 来 说 下 上 面 代码 的 流程 : 如 果 我 们 在 代码 中 写 
下 'phpDocumentor\Reflection\example'，PHP 会 通过 SPL 调 用 loadClass->findFile- 
»findFileWithExtension » 首先 默认 用 php 作 为 文件 后 级 名 调用 
findFileWithExtension 鸣 数 里 ， 利 用 PSR4 标 准 尝 试 解析 目录 文件 ， 如 果 文 件 不 存在 
则 继续 用 PSR0 标 准 解析 ， 如 果 解 析出 来 的 目录 文件 仍然 不 存在 ， 但 是 环境 是 
HHVM 虚 拟 机 ， 继 续 用 后 组 名 为 hh 再 次 调用 findFileWithExtension 有 函数 ， 如 果 不 存 
在 ， 说 明 此 命名 空间 无 法 加 载 ， 放 到 classMap 中 设 为 false， 以 便 以 后 更 快 地 加 载 。 
对 于 phpDocumentor\Reflection\example， 当 尝试 利用 PSR4 标 准 映射 目录 
时 ， 步 骤 如 下 : 


PSR4 标 准 加 载 


e 将 \ 转 为 文件 分 隔 符 /， 加 上 后 级 php 或 hh， 得 到 $logicalPathPsr4 即 
phpDocumentor//Reflection//example.php(hh); 

e 利用 命名 空间 第 一 个 字母 p 作 为 前 级 索引 搜索 prefixLengthsPsr4 数 组 ， 查 
到 下 面 这 个 数组 : 


PHP Composer- 一 一 -注册 与 运行 源码 分 析 


``php 
p' => 
array ( 
' phpDocumentor \\Reflection\\' => 25, 
'phpDocumentorNNFakeNN' => 19, 


e 遍历 这 个 数组 ， 得 到 两 个 顶层 命名 空间 phpDocumentor\Reflection\ 和 
phpDocumentor\Fake\ 

e 用 这 两 个 顶层 命名 空间 与 phpDocumentor\Reflection\example_e 相 比较 ， 
可 以 得 到 phpDocumentor\Reflection\ 这 个 顶层 命名 空间 

e 在 prefixLengthsPsr4 映 射 数组 中 得 到 phpDocumentor\Reflection\ 长 度 为 


25° 
e 在 prefixDirsPsr4 映 射 数组 中 得 到 phpDocumentor\Reflection\ 的 目录 映射 
A: 
' php 
'phpDocumentorNNReflectionNN' => 
array ( 
© => DIR .. '/..' . '/phpdocumentor/reflection-common 
ASNE 
1 => _DIR_ . '/..' . '/phpdocumentor/type-resolver/src 
2 => _DIR_ . '/..' . '/phpdocumentor/reflection-docblo 
ck/src 


e 遍历 这 个 映射 数组 ， 得 到 三 个 目录 映射 ; 

e 查看 “目录 + 文件 分 隔 符 //+substr($logicalPathPsr4, $length)” 文 件 是 否 存 
在 ， 存 在 即 返回 。 这 里 就 是 ' DIR /../phpdocumentor/reflection- 
common/src + /+ 
substr(phpDocumentor/Reflection/example e.php(hh),25)' 

e 如 果 失 败 ， 则 利用 fallbackDirsPsr4 数 组 里 面 的 目录 继续 判断 是 否 存 在 文 
件 ， 上 有 具 体 方 法 是 “目录 + 文件 分 隔 符 //+$logicalPathPsr4” 


PHP Composer- 一 一 -注册 与 运行 源码 分 析 


PSR0 标 准 加 载 


如 果 PSR4 标 准 加 载 失败 ， 则 要 进行 PSR0 标 准 加 载 : 


e 找到 phpDocumentor\Reflection\lexamplee 最 后 的 位 置 ， 将 其 后 面 文件 名 
中 ”字符 转 为 文件 分 隔 符 “/”, 得 到 $logicalPathPsr0 即 
phpDocumentor/Reflection/example/e.php(hh) 利用 命名 空间 第 一 个 字母 p 
作为 前 级 索引 搜索 prefixLengthsPsr4 数 组 ， 查 到 下 面 这 个 数组 : 


`` php 
Ip! => 
array ( 
"Prophecy\\' => 
array ( 
© => DIR .. '/..' . '/phpspec/prophecy/src', 


); 


'phpDocumentor' => 
array ( 
© => DIR .. '/..' . '/erusev/parsedown', 


); 


e 遍历 这 个 数组 ， 得 到 两 个 顶层 命名 空间 phpDocumentor 和 Prophecy 

e 用 这 两 个 顶层 命名 空间 与 phpDocumentonReflection\example e 相 比较 ， 
可 以 得 到 phpDocumentor 这 个 顶层 命名 空间 

e 在 映射 数组 中 得 到 phpDocumentor 目 录 映 射 为 ' DIR. .1..". 
‘/erusev/parsedown' 

e 查看 “目录 + 文件 分 隔 符 //+$logicalPathPsr0” 文 件 是 否 存 在 ， 存 在 即 返 回 。 
这 里 就 是 “DIR_.'..". '/erusev/parsedown + //+ 
phpDocumentor//Reflection//example/e.php(hh)” 

e 如 果 失 败 ， 则 利用 fallbackDirsPsr0 数 组 里 面 的 目录 继续 判断 是 否 存在 文 
件 ， 具 体 方 法 是 “目录 + 文件 分 隔 符 //+$logicalPathPsr0” 

e 如 果 仍 然 找 不 到 ， 则 利用 stream_resolve_include_path()， 在 当前 include 
目录 寻找 该 文件 ， 如 果 找 到 返回 绝对 路 径 。 


结语 


经 过 三 篇 文章 ， 终 于 写 完 了 PHP Composer 自 动 加 载 的 原理 与 实现 ， 结 下 来 我 
们 开始 讲解 laravel 框 架 下 的 门面 Facade, 这 个 门面 功能 和 自动 加 载 有 着 一 些 联系 . 


这 篇 文章 我 们 开始 讲 laravel 框 架 中 的 门面 Facade， 什 么 是 门面 呢 ? 官方 文档 : 
Facades (读音 : /fe'sàd/ ) 为 应 用 程序 的 服务 容器 中 可 用 的 类 提供 了 一 个 


[静态 」 d£ » Laravel 4 # 1 4& 2 facades ， 几 乎 可 以 用 来 访问 到 Laravel 中 
中 那些 底层 类 的 [静态 代 
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所 有 的 服务 。Laravel facades 实际 上 是 服务 容器 
， 相 比 于 传统 的 静态 方法 ，facades 在 提供 了 简洁 且 丰 富 的 语法 同时 ， 还 


理 | 
带 来 了 更 好 的 可 测试 性 和 扩展 性 。 
什么 意思 呢 ? 首先 ， 我 们 要 知道 laravel 框 架 的 核心 就 是 个 loc 容 器 即 服务 
功能 类 似 于 一 个 工厂 模式 ， 是 个 高 级 版 的 工厂 。laravel 的 其 他 功能 例如 路 由 、 缓 
存 、 日 志 、 数 据 库 其 实 都 是 类 似 于 插件 或 者 零件 一 样 ， 叫 做 服务 。loc 容 器 主要 的 作 
用 就 是 生产 各 种 零件 ， 就 是 提供 各 个 服务 。 在 laravel 中 ， 如 果 我 们 想 要 用 某 个 服 

最 简单 的 办 法 就 是 调用 服务 容器 的 make 有 函数 ， 或 者 利用 依赖 注 


务 ， 该 怎么 办 呢 ? 最 简 
入 ， 或 者 就 是 今天 要 讲 的 门面 Facade °。 门面 相对 于 其 他 方法 来 说 ， 最 大 的 特点 就 是 


oe Be 
4 4s ? 


简洁 ， 例 如 我 们 经 常 使 用 的 Router， 如 果 利 用 服务 容器 的 make : 


| php 
App: :make('router')->get('/', function () { 
return view('welcome'); 


3); 


如 果 利 用 门面 : 


| “php 
Route::get('/', function () { 


return view('welcome'); 
3): 
可 以 看 出 代码 更 加 简洁 。 其 实 ， 下 面 我 们 就 会 介绍 门面 最 后 调用 的 函数 也 是 服务 容 
$$ f) make x © 


Facade 的 原理 


我 们 以 Route 为 例 ， 来 讲解 一 下 门面 Facade 的 原理 与 实现 。 我 们 先 来 看 Route 
的 门面 类 : 


”php 
class Route extends Facade 
{ 
protected static function getFacadeAccessor() 
{ 
return 'router'; 
} 


很 简单 吧 ? 其 实 每 个 门面 类 也 就 是 重 定义 一 下 getFacadeAccessor 函 数 就 行 
了 ， 这 个 元 数 返回 服务 的 唯一 名 称 : router。 需 要 注意 的 是 要 确保 这 个 名 称 可 以 用 
服务 容器 的 make 函 数 创建 成 功 (App::make(router))， 原 因 我 们 马上 就 会 讲 到 。 
那么 当 我 们 写 出 Route::get() 这 样 的 语句 时 ， 到 底 发 生 了 什么 呢 ? 奥秘 就 在 基 类 
Facade 中 。 


php 
public static function __callStatic($method, $args) 
{ 


$instance = static::getFacadeRoot(); 


if (! $instance) { 
throw new RuntimeException('A facade root has not been s 
et.'); 
j 


return $instance->$method(...$args); 


4 34 47Route::get()N > ALI] GRoutexR A # Aget) BA » PHP wt AAA i 4- 
ER BZ  callStatic « KATA BIEN ER EA CAU AE: 获得 对 象 实例 ， 利 用 对 
象 调 用 get() 函 数 。 首 先 先 看 看 如 何 获得 对 象 实例 的 : 


`` php 
public static function getFacadeRoot() 


1 


return static::resolveFacadeInstance(static::getFacadeAccess 
or()); 
j 


protected static function getFacadeAccessor() 


{ 
throw new RuntimeException('Facade does not implement getFac 
adeAccessor method.'); 


j 


protected static function resolveFacadeInstance($name) 


1 
if (is object($name)) { 
return $name; 


if (isset(static::$resolvedInstance[$name])) { 
return static::$resolvedInstance[S$name]; 


return static::$resolvedInstance[$name] = static::$app[$name 
]; 
j 


我 们 看 到 基 类 getFacadeRoot() 调 用 了 getFacadeAccessor()， 也 就 是 我 们 的 服 
务 重 载 的 函数 ， 如 果 调 用 了 基 类 的 getFacadeAccessor， 就 会 抛 出 异常 。 在 我 们 的 
例子 里 getFacadeAccessor() 返 回 了 “router”， 接 下 来 getFacadeRoot() 又 调用 了 
resolveFacadelnstance() » ZR + HARES RM 


`` php 
return static::$resolvedInstance[$name] = static::$app[$name]; 


我 们 看 到 ， 在 这 里 利用 了 $app 也 就 是 服务 容器 创建 了 "router， 创 建成 功 后 放 入 
$resolvedlnstance 作 为 缓存 ， 以 便 以 后 快速 加 载 。 好 了 ，Facade 的 原理 到 这 
里 就 讲 完 了 ， 但 是 到 这 里 我 们 有 个 疑惑 ， 为 什么 代码 中 写 Route 就 可 以 调用 
llluminate\Support\Facades\Route 呢 ?这 个 就 是 别名 的 用 途 了 ， 很 多 门面 都 有 自己 
的 别名 ， 这 样 我 们 就 不 必 在 代码 里 面 写 use llluminate\Support\Facades\Route ， 而 
是 可 以 直接 用 Route 了 。 


别名 Aliases 


为 什么 我 们 可 以 在 laravel 中 全 局 用 Route， 而 不 需要 使 用 use 
llluminate\Support\Facades\Route? # & 24h F—‘*+PHP 42 : class alias > È 
可 以 为 任何 类 创建 别名 。laravel 在 启动 的 时 候 为 各 个 门面 类 调用 了 class_alias 函 
数 ， 因 此 不 必 直 接 用 类 名 ， 直 接 用 别名 即 可 。 在 config 文 件 夹 的 app 文 件 里 面 存放 着 
门面 与 类 名 的 映射 : 


”php 
'aliases!' => [ 


'App' => Illuminate\Support\Facades\App::class, 
'Artisan' => Illuminate\Support\Facades\Artisan::class, 
'Auth' => Illuminate\Support\Facades\Auth::class, 


下 面 我 们 来 看 看 laravel 是 如 何 为 门面 类 创建 别名 的 。 


启动 别名 Aliases 服 务 


说 到 |aravel 的 启动 ， 我 们 离 不 开 index.php : 


`` php 
require _ DIR_.'/../bootstrap/autoload.php'; 


$app = require_once DIR_.'/../bootstrap/app.php'; 





$kernel = $app->make(Illuminate\Contracts\Http\Kernel::class); 


$response = $kernel->handle( 
$request = Illuminate\Http\Request: :capture() 


): 


第 一 句 就 是 我 们 前 面 博客 说 的 composer 的 自动 加 载 ， 接 下 来 第 二 句 获 取 |aravel 
核心 的 loc 容 器 ， 第 三 多 “制造 "出 Http 请 求 的 内 核 ， 第 四 名 是 我 们 这 里 的 关键 ， 这 和 多 
牵扯 很 大 ，laravel 里 面 所 有 功能 服务 的 注册 加 载 ， 乃 至 Http 请 求 的 构造 与 传递 都 是 


这 一 句 的 功劳 。 


`` php 
$request = Illuminate\Http\Request::capture() 


这 名 是 |laravel 通 过 全 局 $_ SERVER 数组 构造 一 个 Http 请 求 的 语句 ， 接 下 来 会 调 
用 Http 的 内 核 函 数 handle : 


`` php 


public function handle($request) 


( 


$e)); 


try { 
$request ->enableHttpMethodParameterOverride(); 


$response = $this->sendRequestThroughRouter($request 


} catch (Exception $e) { 
$this->reportException($e) ; 


$response = $this->renderException($request, $e); 


} catch (Throwable $e) { 
$this->reportException($e = new FatalThrowableError( 


$response = $this->renderException($request, $e); 


event(new Events\RequestHandled($request, $response)); 


return $response; 


E handle & Zt > iX F enableHttpMethodParameterOverride $ žk X At 4E X 3e 
+P 4 ll delete ` put XA 497% KR » A114 & A sendRequestThroughRouter : 


`` php 


protected function sendRequestThroughRouter ($request ) 


{ 
$this->app->instance('request', $request); 
Facade: :clearResolvedInstance('request'); 
$this->bootstrap(); 
return (new Pipeline($this->app) ) 
->send($request ) 
->through($this->app->shouldSkipMiddleware( ) 
zu 
$this-»middleware) 
->then($this->dispatchToRouter()); 


AY 7j 4] Æ 4c laravel&gloc È 3€ Brequestis KAY xd HF] > Facade F 73 26. 
request& % 4 & 9| » bootstrap : 


' php 
public function bootstrap() 
{ 
if (! $this->app->hasBeenBootstrapped()) ( 
$this->app->bootstrapWith($this->bootstrappers()); 


protected $bootstrappers = [ 
NIlluminateNFoundationNBootstrapNLoadEnvironmentVariable 
s::class, 
\Illuminate\Foundation\Bootstrap\LoadConfiguration: :clas 


S, 

NIlluminateNFoundationNBootstrapNHandleExceptions::class 
, 

NIlluminateNFoundationNBootstrapNRegisterFacades::class, 

NIlluminateNFoundationNBootstrapNRegisterProviders::clas 
S, 


NIlluminateNFoundationNBootstrapNBootProviders::class, 


I; 


$bootstrappers Æ Http A 4% €. 4 1178 TÆ 35 89 204 > bootstrap i žk Y 78/7 loc% 
& &) bootstrapWith 函数 来 创建 这 些 组 件 并 利用 组 件 进行 启动 服务 。app- 
>bootstrapWith : 


`` php 
public function bootstrapWith(array $bootstrappers) 


{ 


$this->hasBeenBootstrapped = true; 
foreach ($bootstrappers as $bootstrapper) { 
$this['events']->fire('bootstrapping: '.$bootstrappe 
r, [$this]); 
$this-»make($bootstrapper)-»bootstrap($this); 
$this['events']-»fire('bootstrapped: '.$bootstrapper 


, [$this]); 
} 


可 以 看 到 bootstrapWith 有 函数 也 就 是 利用 loc 容 器 创建 各 个 启动 服务 的 实例 后 ， 
回调 启动 自己 的 函数 bootstrap， 在 这 里 我 们 只 看 我 们 Facade 的 启动 组 件 


php 
NIlluminateNFoundationNBootstrapNRegisterFacades::class 


RegisterFacades 5j bootstrap £X : 


`` php 
class RegisterFacades 


{ 
public function bootstrap(Application $app) 


{ 


Facade: :clearResolvediInstances(); 
Facade: :setFacadeApplication($app); 


AliasLoader: :getInstance($app->make('config')->get('app. 
aliases', [])) 
->register(); 


可 以 看 出 来 ，bootstrap 做 了 一 下 几 件 事 : 


清除 了 Facade 中 的 缓存 

设置 Facade 的 loc 容 器 

获得 我 们 前 面 讲 的 config 文 件 夹 里 面 app 文 件 aliases 别 名 映射 数组 
使 用 aliases 实 例 化 初始 化 AliasLoader 


调用 AliasLoader->register() 


QN, HO he am 


| php 
public function register() 


{ 
if (! $this->registered) { 
$this-»prependToLoaderStack(); 
$this->registered = true; 
} 
} 
protected function prependToLoaderStack() 
{ 
spl_autoload_register([$this, 'load'], true, true); 


我 们 可 以 看 出 ， 别 名 服务 的 启动 关键 就 是 这 个 spl_autoload register > 3X 4- & 
数 我 们 应 该 很 熟悉 了 ， 在 自动 加 载 中 这 个 函数 用 于 解析 命名 空间 ， 在 这 里 用 于 解 术 
9| 8) REX E o 


别名 Aliases 服 务 


我 们 首先 来 看 看 被 注册 到 spl autoload register 的 函数 ，load : 


`` php 
public function load($alias) 


x 
if (static::$facadeNamespace && strpos($alias, 
static: :$facadeNamespace 
) = 0) { 

$this->loadFacade($alias); 

return true; 
} 
if (isset($this->aliases[$alias])) { 

return class_alias($this->aliases[$alias], $alias); 
i 


这 个 函数 的 下 面 很 好 理解 ， 就 是 class_alias 利 用 别名 映射 数组 将 别名 映射 到 站 
正 的 门面 类 中 去 ， 但 是 上 面 这 个 是 什么 呢 ? 实 际 上 ， 这 个 是 laravel5.4 版 本 新 出 的 功 
能 叫做 实时 门面 服务 。 


实时 门面 服务 


其 实 门面 功能 已 经 很 简单 了 ， 我 们 只 需要 定义 一 个 类 继承 Facade 即 可 ， 但 是 
laravel5.4 打 算 更 近 一 步 一 一 自动 生成 门面 子 类 ， 这 就 是 实时 门面 。 实时 门面 
怎么 用 ?看 下 面 的 例子 : 


`` php 
namespace App\Services; 


class PaymentGateway 


{ 
protected $tax; 
public function — construct(TaxCalculator $tax) 
{ 
$this->tax = $tax; 
} 


这 是 一 个 自 定 义 的 类 ， 如 果 我 们 想 要 为 这 个 类 定义 一 个 门面 ， 在 laravel5.4 我 们 可 以 
AU: 


`` php 
use Facades\ { 
App\Services\Payment Gateway 


Fa 


Route: :get('/pay/{amount}', function ($amount) { 
PaymentGateway: :pay($amount); 


PO 


当然 如 果 你 愿意 ， 你 还 可 以 在 alias 数 组 为 门面 添加 一 个 别名 映 
射 "PaymentGateway" => "use Facades\App\Services\PaymentGateway"， 这 样 就 
不 用 写 这 么 长 的 名 字 了 。 那么 这 么 做 的 原理 是 什么 呢 ? 我 们 接着 看 源码 : 


`` php 


protected static $facadeNamespace = 'Facades\\'; 
if (static::$facadeNamespace && strpos($alias, static::$facadeNa 
mespace) === 0) { 


$this->loadFacade($alias); 


return true; 


如 果 命 名 空间 是 以 Facades\ 开 头 的 ， 那 么 就 会 调用 实时 门面 的 功能 ， 调 用 
loadFacade $% 2 : 


`` php 
protected function loadFacade($alias ) 
{ 
tap($this->ensureFacadeExists($alias), function ($path) { 
require $path; 
3) 


tap €laravel ay 5j # 84 & ZX > ensureFacadeExists $ Z& fi A zh ^E LT] DR > 
loadFacade $i it Ze HK] OR : 


* php 
protected function ensureFacadeExists($alias) 
{ 
if (file_exists($path = storage path('framework/cache/fa 
cade-'.shai($alias).'.php'))) { 
return $path; 


file put contents($path, $this->formatFacadeStub( 
$alias, file get contents( DIR .'/stubs/facade.stu 
b') 
)); 


return $path; 


可 以 看 出 来 ，laravel 框 架 生 成 的 门面 类 会 放 到 stroge/framework/cache/ 文 件 夹 
下 ， 名 字 以 facade 开 头 ， 以 命名 空间 的 哈 希 结尾 。 如 果 存 在 这 个 文件 就 会 返回 ， 否 
则 就 要 利用 file_put_contents 生 成 这 个 文件 ，formatFacadeStub : 


”php 
protected function formatFacadeStub($alias, $stub) 
x 
$replacements = [ 
str replace('/', '\\', dirname(str replace('NN', '/' 
, $alias))), 

class basename($alias), 
substr($alias, strlen(static::$facadeNamespace)), 


ja 


return str_replace( 
['DummyNamespace', 'DummyClass', 'DummyTarget'], $re 
placements, $stub 


); 


简单 的 说 ， 对 于 Facades\App\Services\PaymentGateway > $replacements # — 75i 
是 门面 命名 空间 ， 将 Facades\App\Services\PaymentGateway 转 为 
Facades/App/Services/PaymentGateway > Xt ij @Facades/App/Services/ > #+4% 
7; 4r % % la] Facades\App\Services\ ; 第 二 项 是 门面 类 名 ，PaymentGateway ; 第 三 
项 是 门面 类 的 服务 对 象 ，App\Services\PaymentGateway， 用 这 些 来 替换 门面 的 模 
板 文件 : 


`` php 
<?php 


namespace DummyNamespace; 
use Illuminate\Support\Facades\Facade; 


ff oia 
* @see \DummyTarget 
af 
class DummyClass extends Facade 
i 
VALUES 
* Get the registered name of the component. 
* 
* @return string 
p 
protected static function getFacadeAccessor() 


( 


return 'DummyTarget'; 


替换 后 的 文件 是 : 


`` php 
<?php 


namespace Facades\App\Services\; 
use Illuminate\Support\Facades\Facade; 


Vata: 
* @see \DummyTarget 
2^ 
class PaymentGateway extends Facade 


{ 
VERE 
* Get the registered name of the component. 


* 


* Qreturn string 
uA 
protected static function getFacadeAccessor() 


{ 


return 'AppNServicesNPaymentGateway'; 


就 是 这 么 简单 1 |! | 
结语 


门面 的 原理 就 是 这 些 ， 相 对 来 说 门面 服务 的 原理 比较 简单 ， 和 自动 加 载 相互 配 
合 使 得 代码 更 加 简洁 ， 硕 望 大 家 可 以 更 好 的 使 用 这 些 门 面 ! 


服务 


yy 
H 


在 说 loc 容器 之 前 ， 我 们 需要 了 解 什 么 C 容器 。 
Laravel 服务 容器 是 一 个 用 于 管理 类 依赖 和 执行 依赖 注入 的 强大 工具 。 


在 理解 这 和 句 话 之 前 ， 我 们 需要 先 了 解 一 下 服务 容器 的 来 龙 去 脉 : laravel 神 奇 的 服务 
容器 。 这 篇 博客 告诉 我 们 ， 服 务 容器 就 是 工厂 模式 的 升级 版 ， 对 于 传统 的 工厂 模式 
来 说 ， 虽 然 解 厅 了 对 象 和 外 部 资源 之 间 的 关系 ， 但 是 工厂 和 外 部 资源 之 间 却 存在 了 
NEHME eh a AA it HR A YY ^ LA PSB IR AUR ETT RA? 
个 就 是 loc 容器 。 ”所谓 的 依赖 注入 和 控制 反 转 : 依赖 注入 和 控制 捅 转 ， 就 是 


只 要 不 是 由 内 部 生产 (比如 初始 化 、 构 造 函 数 construct 中 通过 工厂 方法 、 
自行 手动 new 的 ) ， 而 是 由 外 部 以 参数 或 其 他 形式 注入 的 ， 都 属于 依赖 注入 
(DI) 


也 就 是 说 : 


[t 
J% 


依赖 注入 是 从 应 用 程序 的 角度 在 描述 ， 可 以 把 依赖 注入 描述 完整 点 : 应 用 
依赖 容器 创建 并 注入 它 所 需要 的 外 部 资源 ; 


控制 反 转 是 从 容器 的 角度 在 描述 ， 描 述 完 整 点 : 容器 控制 应 用 程序 ， 由 容器 反 
向 的 向 应 用 程序 注入 应 用 程序 所 需要 的 外 部 资源 。 


Laravel 中 的 服务 容器 


Laravel 服 务 容 器 主要 承担 两 个 作用 : 2p 5 BENT o 


BB 


所 谓 的 绑 定 就 是 将 接口 与 实现 建立 对 应 关系 。 几 乎 所 有 的 服务 容器 绑 定 都 是 在 服务 
提供 者 中 完成 ， 也 就 是 在 服务 提供 者 中 绑 定 。 


如 果 一 个 类 没有 基于 任何 接口 那么 就 没有 必要 将 其 绑 定 到 容器 。 容 器 并 不 需要 
被 告知 如 何 构建 对 象 ， 因 为 它 会 使 用 PHP 的 反射 服务 自动 解析 出 具体 的 对 
$ o 
也 就 是 说 ， 如 果 需 要 依赖 注入 的 外 部 资源 如 果 没 有 接口 ， 那 么 就 不 需要 绑 定 ， 直 接 
利用 服务 容器 进行 解析 就 可 以 了 ， 服 务 容器 会 根据 类 名 利用 反射 对 其 进行 自动 构 


io 


bind Æ 


绑 定 有 多 种 方法 ， 首 先 最 常用 的 是 bind 函 数 的 绑 定 : 


e BWA 


$this->app->bind( 'App\Services\RedisEventPusher', null); 


e RERE 


$this->app->bind('name', function () { 


return 'Taylor'; 


));// Hu &ikw d 


$this->app->bind('HelpSpot\API', function () { 


return HelpSpot\API: :class; 


});// 闭 包 直 接 提供 类 实现 方式 


public function testSharedClosureResolution() 


( 


$container - new Container; 

$class - new stdClass; 

$container->bind('class', function () use ($class) { 
return $class; 


3): 


$this->assertSame($class, $container-»make('class')); 


)//W &ik m Xe 


$this-»app-»-bind('HelpSpotNAPI', function () { 


return new HelpSpot\API(); 


});// 闭 包 直 接 提供 类 实现 方式 


$this->app->bind('HelpSpot\API', function ($app) { 


return new HelpSpot\API($app->make('HttpClient')); 


});// 闭 包 返 回 需 要 依赖 注入 的 类 


e FERU 


2 


loC 服务 容器 





Laravel Container 


public function testCanBuildWithoutParameterStackWithConstructors 


() 
{ 


$container = new Container; 
$container ->bind( 'Illuminate\Tests\Container\IContainerContr 
actStub ' ， 
'IlluminateNTestsNContainerNContainerImplem 
entationStub'); 


$this->assertInstanceOf(ContainerDependentStub: :class, 
$container ->build(ContainerDependent 
Stub::class)); 
} 


interface IContainerContractStub 


{ 
} 


class ContainerImplementationStub implements IContainerContractS 
tub 


{ 
} 
class ContainerDependentStub 
X 
public $impl; 
public function _ construct(IContainerContractStub $impl) 
t 
$this->impl = $impl; 
} 
} 


| 
这 三 种 绑 定 方式 中 ， 第 一 种 绑 定 自身 一 般 用 于 绑 定 单 例 。 


bindif 绑 定 


68 


public function testBindIfDoesntRegisterIfServiceAlreadyRegister 
ed() 


{ 
$container = new Container; 
$container->bind('name', function () 
return 'Taylor'; 


3): 


$container->bindIf('name', function () { 
return 'Dayle'; 


3): 


$this->assertEquals('Taylor', $container-»make( name')); 


singleton ži € 


singleton 方法 绑 定 一 个 只 需要 解析 一 次 的 类 或 接口 到 容器 ， 然 后 接 下 来 对 容器 的 调 
用 将 会 返回 同一 个 实例 : 


$this->app->singleton('HelpSpot\API', function ($app) { 
return new HelpSpot\API($app->make('HttpClient')); 
3); 


值得 注意 的 是 ，singleton 绑 定 在 解析 的 时 候 若 存在 参数 重 载 ， 那 么 就 自动 取消 单 例 
模式 。 


public function testSingletonBindingsNotRespectedwithMakeParamet 
ers() 


{ 


$container = new Container; 


$container->singleton('foo', function ($app, $config) { 
return $config; 


3): 


$this->assertEquals(['name' => 'taylor'], $container-»makeWi 
th('foo', ['name' => 'taylor'])); 

$this->assertEquals(['name' => 'abigail'], $container-»makeW 
ith('foo', ['name' => 'abigail'])); 


j 


instance2f x 


我 们 还 可 以 使 用 instance 2: i£ 2px — ^ ERRA SEIS] RES 0 MEAARRE 
总 是 返回 给 定 的 实例 : 


$api = new HelpSpot\API(new HttpClient); 
$this->app->instance('HelpSpot\Api', $api); 


Context € 


有 时 候 我 们 可 能 有 两 个 类 使 用 同一 个 接口 ， 但 我 们 希望 在 每 个 类 中 注入 不 同 实现 ， 
例如 ， 两 个 控制 器 依赖 llluminate\Contracts\Filesystem\Filesystem 32 24 49 # FF] S: 
3 o Laravel 为 此 定义 了 简单 、 平 滑 的 接口 : 


use Illuminate\Support\Facades\Storage; 

use App\Http\Controllers\VideoController; 

use App\Http\Controllers\PhotoControllers; 

use Illuminate\Contracts\Filesystem\Filesystem; 


$this->app->when(StorageController::class) 
-»needs(Filesystem::class) 
-»give(function () { 
Storage::class 
J); / HR AA 


$this->app->when(PhotoController::class) 
-»needs(Filesystem::class) 
-»give(function () ( 
return new Storage( ); 
} );// 提 供 实现 方式 


$this->app->when(VideoController::class) 
-»needs(Filesystem::class) 
-»give(function () ( 
return new Storage($app-»make(Disk::class)); 
} );// 需 要 依赖 注入 
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我 们 可 能 有 一 个 接收 注入 类 的 类 ， 同 时 需要 注入 一 个 原生 的 数值 比如 整 型 ， 可 以 结 
合 上 下 文 轻松 注入 这 个 类 需要 的 任何 值 : 


$this->app->when( 'App\Http\Controllers\UserController' ) 


->needs('SvariableName' ) 
->give($value) ; 


Hy ZA x 
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类 名 字符 串 ,并 不 能 返回 实现 类 的 对 象 。 


public function testArrayAccess() 


{ 
$container = new Container; 
$container[IContainerContractStub::class] = ContainerImpleme 
ntationStub::class; 


$this->assertTrue(isset($container [IContainerContractStub: :c 
lass])); 
$this->assertEquals(ContainerImplementationStub::class, 
$container[IContainerContractStub::class 


]); 


unset ($container['something']); 
$this-»assertFalse(isset($container['something'])); 


TARE 


少数 情况 下 ， 我 们 需要 解析 特定 分 类 下 的 所 有 绑 定 ， 例 如 ， 你 正在 构建 一 个 接收 多 
个 不 同 Report 接口 实现 的 报告 聚合 器 ， 在 注册 完 Report 实现 之 后 ， 可 以 通过 tag 


方法 给 它们 分 配 一 个 标签 : 


$this->app->bind('SpeedReport', function () { 
Hi 
3); 


$this->app->bind('MemoryReport', function () { 
Mi 
}); 


$this->app->tag(['SpeedReport', 'MemoryReport'], 'reports'); 
这 些 服 务 被 打上 标签 后 ， 可 以 通过 tagged 方法 来 轻松 解析 它们 : 
$this->app->bind('ReportAggregator', function ($app) { 


return new ReportAggregator($app->tagged('reports')); 
3): 


public function testContainerTags( ) 
{ 
$container = new Container; 
$container ->tag( 'Illuminate\Tests\Container\ContainerIm 
plementationStub', 'foo', 'bar'); 
$container-»-tag('IlluminateNTestsNContainerNContainerIm 
plementationStubTwo', ['foo']); 


$this->assertCount(i, $container-»tagged('bar')); 
$this->assertCount(2, $container->tagged('foo')); 
$this->assertInstanceOf( 'Illuminate\Tests\Container\Con 
tainerImplementationStub', $container->tagged('foo')[0]); 
$this->assertInstanceOf( 'Illuminate\Tests\Container\Con 
tainerImplementationStub', $container->tagged('bar')[0]); 
$this->assertInstanceOf('Illuminate\Tests\Container\Con 
tainerImplementationStubTwo', $container->tagged('foo')[1]); 


$container = new Container; 

$container ->tag(['Illuminate\Tests\Container\Containerl 
mplementationStub', 'Illuminate\Tests\Container\ContainerImpleme 
ntationStubTwo'], ['foo']); 

$this->assertCount(2, $container->tagged('foo')); 

$this->assertInstanceOf('Illuminate\Tests\Container\Con 
tainerImplementationStub', $container->tagged('foo')[0]); 

$this->assertInstanceOf('Illuminate\Tests\Container\Con 
tainerImplementationStubTwo', $container->tagged('foo')[1]); 


$this->assertEmpty($container->tagged('this_tag_does_n 


ot_exist')); 


} 


extend 扩 展 


extend 是 在 当 原 来 的 类 被 注册 或 者 实例 化 出 来 后 ， 可 以 对 其 进行 扩展 ， 而 且 可 以 支 
持 多 重 扩展 : 


public function testExtendInstancesArePreserved( ) 


{ 
$container = new Container; 
$container->bind('foo', function () { 
$obj = new StdClass; 
$0bj->foo = 'bar'; 


return $0obj; 


3): 


$obj = new StdClass; 
$0bj->foo = 'foo'; 
$container->instance('foo', $0bj); 


$container->extend('foo', function ($0bj, $container) { 
$o0bj->bar = 'baz'; 
return $obj; 


3); 


$container->extend('foo', function ($0bj, $container) ( 
$0bj->baz = 'foo'; 
return $obj; 


3): 


$this->assertEquals('foo', $container-»make('foo')-»foo); 
$this->assertEquals('baz', $container->make('foo')->bar); 
$this->assertEquals('foo', $container->make('foo')->baz); 


Rebounds 5 Rebinding 


绑 定 是 针对 接口 的 ， 是 为 接口 提供 实现 方式 的 方法 。 我 们 可 以 对 接口 在 不 同 的 时 间 
段 里 提供 不 同 的 实现 方法 ， 一 般 来 说 ， 对 同一 个 接口 提供 新 的 实现 方法 后 ， 不 会 对 
已 经 实例 化 的 对 象 产生 任何 影响 。 但 是 在 一 些 场景 下 ， 在 提供 新 的 接口 实现 后 ， 我 
们 希望 对 已 经 实例 化 的 对 象 重新 做 一 些 改变 ， 这 个 就 是 rebinding 函数 的 用 途 。 下 
面 就 是 一 个 例子 : 


Laravel Container——loC 服务 容器 


abstract class Car 


public function __construct(Fuel $fuel) 
{ 
$this->fuel = $fuel; 
} 
public function refuel($litres) 
{ 
return $litres * $this->fuel->getPrice(); 
} 
public function setFuel(Fuel $fuel) 
{ 
$this->fuel = $fuel; 
} 
} 
class Jeepwrangler extends Car 
{ 
// 
} 
interface Fuel 
{ 
public function getPrice(); 
} 
class Petrol implements Fuel 
{ 
public function getPrice() 
{ 
return 130.7; 
j 
} 


我 们 在 服务 容器 中 是 这 样 对 car 接 口 和 fuel 接 口 绑 定 的 : 
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$this->app->bind('fuel', function ($app) { 
return new Petrol; 


3); 


$this->app->bind('car', function ($app) { 
return new JeepWrangler($app['fuel']); 
3); 


$this->app->make('car'); 


如 果 car 被 服务 容器 解析 实例 化 成 对 象 之 后 ， 有 人 修改 了 fuel 接口 的 实现 ， 从 
Petrol 改 为 PremiumPetrol : 


$this->app->bind('fuel', function ($app) { 
return new PremiumPetrol; 


3); 


由 于 car 已 经 被 实例 化 ， 那 么 这 个 接口 实现 的 改变 并 不 会 影响 到 car 的 实现 ， 假 若 
我 们 想 要 car HORA ES fuel 随 着 fuel 接口 的 变化 而 变化 ， 我 们 就 需要 一 个 回调 函 
数 ， 每 当 对 fuel 接口 实现 进行 改变 的 时 候 ， 都 要 对 car 的 fuel 变量 进行 更 新 ， 这 就 
是 rebinding 的 用 途 : 


$this->app->bindShared('car', function ($app) { 
return new JeepWrangler($app->rebinding('fuel', function ($a 
pp, $fuel) { 
$app['car']->setFuel($fuel); 
3); 
3): 


在 说 服务 容器 的 解析 之 前 ， 需 要 先 说 说 服务 的 别名 。 什 么 是 服务 别名 呢 ?不 同 于 上 

一 个 博客 中 提 到 的 Facade 门面 的 别名 (在 config/app 中 定义 )， 这 里 的 别名 服务 绑 

定名 称 的 别名 。 通 过 服务 绑 定 的 别名 ， 在 解析 服务 的 时 候 ， 跟 不 使 用 别名 的 效果 一 

致 。 别 名 的 作用 也 是 为 了 同时 支持 全 类 型 的 服务 绑 定 名 称 以 及 简短 的 服务 绑 定 名 称 

考虑 的 。 ”通俗 的 讲 ， 假 如 我 们 想 要 创建 auth 服务 ， 我 们 既 可 以 这 样 写 : 
$this->app->make('auth') 


又 可 以 写成 : 


$this->app->make('\Illuminate\Auth\AuthManager::class' ) 


还 可 以 写成 
$this->app->make('\Illuminate\Contracts\Auth\Factory::class') 
后 面 两 个 服务 的 名 字 都 是 auth 的 别名 ， 使 用 别名 和 使 用 auth 的 效果 是 相同 的 。 

服务 别名 的 递归 
需要 注意 的 是 别名 是 可 以 递归 的 : 


app()->alias('service', “alias a’); 
app()->alias('alias_a', 'alias b'); 
app()-alias('alias b', 'alias_c'); 


n» 


会 得 到 : 
'alias a' => 'service' 


'alias b' => 'alias a' 
walias e => kalas pi 


服务 别名 的 实现 


那么 这 些 别 名 是 如 何 加 载 到 服务 容器 里 面 的 呢 ? 实际 上 ， 服 务 容 器 里 面 有 个 aliases 
数组 : 


$aliases = [ 

'app' => [\Illuminate\Foundation\Application::class, \Illumina 
te\Contracts\Container\Container::class, \Illuminate\Contracts\F 
oundation\Application::class], 

'auth' => [\Illuminate\Auth\AuthManager::class, NIlluminateNCo 
ntracts\Auth\Factory::class], 

'auth.driver' => [\Illuminate\Contracts\Auth\Guard::class], 

'blade.compiler' => [NIlluminateNViewNCompilersNBladeCompiler: 
:class], 

'cache' => [NIlluminateNCacheNCacheManager::class, \Illuminate 
NContractsNCacheNFactory::class], 


而 服务 容器 的 初始 化 的 过 程 中 ， 会 运行 一 个 函数 : 


public function registerCoreContainerAliases() 
{ 
foreach ($aliases as $key => $aliases) { 
foreach ($aliases as $alias) { 
$this->alias($key, $alias); 


public function alias($abstract, $alias) 
{ 


$this->aliases[$alias] = $abstract; 


$this->abstractAliases[$abstract][] = $alias; 


加 载 后 ， 服 务 容 器 的 aliases 和 abstractAliases 数 组 : 
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$aliases = [ 
'Illuminate\Foundation\Application' = "app" 
'IlluminateNContractsNContainerNContainer' = "app" 
'Illuminate\Contracts\Foundation\Application' = "app" 
'IlluminateNAuthNAuthManager' = "auth" 
'IlluminateNContractsNAuthNFactory' = "auth" 
'IlluminateNContractsNAuthNGuard' = "auth.driver" 
'IlluminateNViewNCompilersNBladeCompiler' = "blade.compiler" 
'IlluminateNCacheNCacheManager' = "cache" 
'IlluminateNContractsNCacheNFactory' = "cache" 


] 


$abstractAliases = [ 
app = {array} [3] 


© = "Illuminate\Foundation\Application" 
1 = "Illuminate\Contracts\Container\Container" 
2 = "Illuminate\Contracts\Foundation\Application" 


auth = {array} [2] 

© = "IlluminateNAuthNAuthManager " 

1 = "Illuminate\Contracts\Auth\Factory" 
auth.driver = {array} [1] 

© = "Illuminate\Contracts\Auth\Guard" 
blade.compiler = {array} [1] 

© = "Illuminate\View\Compilers\BladeCompiler" 
cache = {array} [2] 

© = "Illuminate\Cache\CacheManager" 

1 = "Illuminate\Contracts\Cache\Factory" 


make 解析 


有 很 多 方式 可 以 从 容器 中 解析 对 象 ， 首 先 ， 你 可 以 使 用 make 方法 ， 该 方法 接收 你 
想 要 解析 的 类 名 或 接口 名 作为 参数 : 


A 
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public function testAutoConcreteResolution( ) 
{ 
$container = new Container; 
$this->assertInstanceOf( 'Illuminate\Tests\Container\Containe 
rConcreteStub', 
$container-»make('IlluminateNTestsNContainerNContaine 
rConcreteStub')); 


} 


// 带 有 依赖 注入 和 默认 值 的 解析 
public function testResolutionOfDefaultParameters() 
{ 
$container = new Container; 
$instance = $container ->make( 'Illuminate\Tests\Container\ 
ContainerDefaultValueStub' ); 
$this->assertInstanceOf('Illuminate\Tests\Container\Conta 
inerConcreteStub', 
$instance->stub); 
$this->assertEquals('taylor', $instance->default); 


YY 
public function testResolvingWithArrayOfParameters() 


( 


$container - new Container; 


$instance = $container-»makeWith(ContainerDefaultValueStub:: 
class, ['default' => 'adam']); 
$this->assertEquals('adam', $instance-»default); 


$instance = $container ->make(ContainerDefaultValueStub: :clas 


s); 
$this->assertEquals('taylor', $instance-»default); 


$container--bind('foo', function ($app, $config) { 
return $config; 
}); 
$this->assertEquals([1, 2, 3], $container->makeWith('foo', [1 


, 2, 3))); 
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public function testNestedDependencyResolution() 
{ 

$container = new Container; 

$container ->bind( 'Illuminate\Tests\Container\IContainerContr 
actStub', 'Illuminate\Tests\Container\ContainerImplementationStu 
b'); 

$class = $container->make( 'Illuminate\Tests\Container\Contai 
nerNestedDependentStub' ); 

$this->assertInstanceOf( 'Illuminate\Tests\Container\Containe 
rDependentStub', $class->inner); 

$this->assertInstanceOf('Illuminate\Tests\Container\Containe 
rImplementationStub', $class->inner->impl); 


} 


class ContainerDefaultValueStub 
{ 

public $stub; 

public $default; 

public function __construct(ContainerConcreteStub $stub, $de 
fault = 'taylor') 


{ 
$this->stub = $stub; 
$this->default = $default; 
} 
} 
class ContainerConcreteStub 
{ 
} 


class ContainerImplementationStub implements IContainerContractS 
tub 

{ 

j 


class ContainerDependentStub 


{ 
public $impl; 
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public function — construct(IContainerContractStub $impl) 


{ 
$this->impl = $impl; 
} 
} 
class ContainerNestedDependentStub 
{ 
public $inner; 
public function _ construct(ContainerDependentStub $inner) 
{ 
$this->inner = $inner; 
} 
} 


JE E eter SX FX] 


如 果 你 所 在 的 代码 位 置 访问 不 了 $app BE "YO da BB XXresolve : 


$api = resolve('HelpSpot\API'); 


自动 注入 
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namespace App\Http\Controllers; 
use App\Users\Repository as UserRepository; 


class UserController extends Controller{ 
[pre 
* 用 户 仓 库 实 例 
*/ 
protected $users; 


fenus 

* 创建 一 个 控制 器 实例 

* @param UserRepository $users 自动 注入 
* @return void 


27 
public function __construct(UserRepository $users) 
{ 
$this->users = $users; 
} 


call 方法 注入 


make 解析 是 服务 容器 进行 解析 构建 类 对 象 时 所 用 的 方法 ， 在 实际 应 用 中 ， 还 有 另 
外 一 个 需求 ， mais A CARRY — A RMR? L1 28 CRI CIAA A h 
数 ， 这 时 发 现 这 个 方法 中 参数 众多 ， 如 果 一 个 个 的 make SHAKE H > 3x ARN ME SE 
要 用 到 call 解析 了 。 我 们 可 以 看 这 个 例子 





class TaskRepository( 


public function testContainerCall(User $user,Task $task){ 
$this->assertInstanceOf(User::class, $user); 


$this->assertInstanceOf(Task::class, $task); 
public static function testContainerCallStatic(User $user,Ta 
sk $task){ 
$this->assertInstanceOf(User::class, $user); 
$this->assertInstanceOf(Task::class, $task); 


public function testCallback()f{ 
echo 'call callback successfully!'; 


public function testDefaultMethod(){ 
echo 'default Method successfully!'; 


HH] & BREA 


public function testCallwithDependencies() 
{ 


$container = new Container; 
$result = $container->call(function (StdClass $foo, $bar = 


Imo 


return func get args(); 


+); 


$this->assertInstanceOf('stdClass', $result[0]); 
$this->assertEquals([], $result[1]); 


$result = $container->call(function (StdClass $foo, $bar = 


yos 


return func get args(); 
jJ, ['bar' => 'taylor']); 


$this->assertInstanceOf('stdClass', $result[0]); 
$this->assertEquals('taylor', $result[1]); 


`Z 


普通 函数 注入 


public function testCallwithGlobalMethodName() 
{ 


$container = new Container; 
$result = $container ->call('Illuminate\Tests\Container\conta 


inerTestInject'); 
$this-»-assertInstanceOf('IlluminateNTestsNContainerNContaine 


rConcreteStub', $result[0]); 
$this->assertEquals('taylor', $result[1]); 


静态 方法 注入 


服务 容器 的 call 解析 主要 依靠 call_user_func_array() 函数 ， 关 于 这 个 函数 可 以 查 
看 Laravel 学 习 笔 记 之 Callback Type - 来 生 做 个 漫画 家 ， 这 个 函数 对 类 中 的 静态 元 
He Ho HEAP A HALRB > MHA RAR: 


class ContainerCallTest 


{ 
public function testContainerCallStatic(){ 
App::call(TaskRepository::class.'QtestContainerCallStati 
c); 
App::call(TaskRepository::class.'::testContainerCallStat 
aos. 
App::call([TaskRepository::class, 'testContainerCallStati 
c']); 
j 
j 


服务 容器 调用 类 的 静态 方法 有 三 种 ， 注 意 第 三 种 使 用 数组 的 形式 ， 数 组 中 可 以 直 
传 类 名 TaskRepository::class ; 


非 静 态 方法 注入 


对 于 类 的 非 静态 方法 : 


class ContainerCallTest 


{ 
public function testContainerCall(){ 
$taskRepo = new TaskRepository(); 
App::call(TaskRepository::class.'QtestContainerCall'); 
App: :call([$taskRepo, 'testContainerCall']); 
} 
} 


我 们 可 以 看 到 非 静态 方法 只 有 两 种 调用 方式 ， 而 且 第 二 种 数组 传递 的 参数 是 美 对 
象 ， 原 因 就 是 call user. func _array 函 数 的 限制 ， 对 于 非 静 态 方法 只 能 传递 对 象 。 


bindmethod 方法 绑 定 


服务 容器 还 有 一 个 bindmethod 的 方法 ， 可 以 绑 定 类 的 一 个 方法 到 自 定 义 的 函数 : 


public function testContainCallMethodBind(){ 


App: :bindMethod(TaskRepository::class.'QtestContainerCallSta 
Lucr x unctr*omet ct 
$taskRepo = new TaskRepository(); 
$taskRepo->testCallback(); 


3): 


App: :call(TaskRepository::class. '@testContainerCallStatic'); 
App: :call(TaskRepository: :class.'::testContainerCallStatic' ) 


App: :call([TaskRepository::class, 'testContainerCallStatic']) 


App: :bindMethod(TaskRepository::class.'QtestContainerCall',f 
unction (TaskRepository $taskRepo) { $taskRepo->testCallback(); 


3); 


$taskRepo - new TaskRepository(); 
App::call(TaskRepository::class.'QtestContainerCall'); 
App: :call([$taskRepo, 'testContainerCall']); 


从 结果 上 看 ，bindmethod 不 会 对 静态 的 第 二 种 解析 方法 ( :: 解析 方式 ) 起 作用 ， 
对 于 其 他 方式 都 会 调用 绑 定 的 函数 。 
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public function testCallwithBoundMethod() 
{ 
$container = new Container; 
$container ->bindMethod( 'Illuminate\Tests\Container\Contain 
erTestCallStub@unresolvable', function ($stub) { 
return $stub->unresolvable('foo', 'bar'); 
3); 
$result = $container-»call('IlluminateNTestsNContainerNCon 
tainerTestCallStub@unresolvable' ); 
$this->assertEquals(['foo', 'bar'], $result); 


$container = new Container; 

$container ->bindMethod( 'Illuminate\Tests\Container\Contain 
erTestCallStub@unresolvable', function ($stub) { 

return $stub->unresolvable('foo', 'bar'); 
3); 

$result = $container->call( [new ContainerTestCallStub, ‘un 
resolvable']); 

$this->assertEquals(['foo', 'bar'], $result); 


class ContainerTestCallStub 


{ 


public function unresolvable($foo, $bar) 


{ 


return func_get_args(); 


PRU IEA 


用 ， 并 不 需要 对 象 。 默 认 


public function testContainCallDefultMethod(){ 
App: :call(TaskRepository: :class,[], 'testContainerCall'); 


App: :call(TaskRepository: :class,[], 'testContainerCallStatic' 
); 


App: :bindMethod(TaskRepository::class.'QtestContainerCallSta 


Lig tumnct Eon Cy: 


$taskRepo = new TaskRepository(); 
$taskRepo->testCallback(); 
3): 


App: :bindMethod(TaskRepository::class.'QtestContainerCall',f 


unction (TaskRepository $taskRepo) ( $taskRepo->testCallback(); 
3); 


App::call(TaskRepository::class,[], 'testContainerCall'); 


App::call(TaskRepository::class,[], 'testContainerCallStatic' 
); 


值得 注意 的 是 ， 这 种 默认 元 数 注入 的 方法 使 得 非 静 态 的 方法 也 可 以 利用 类 名 去 调 
函数 注入 也 回 受到 bindmethod 函数 的 影响 。 


数组 解析 
app()['service']; 


app($service) 5576 X, 


app('service'); 


每 当 服 务 容器 解析 一 个 对 象 时 就 会 触发 一 个 事件 。 你 可 以 使 用 resolving 方法 监听 
这 


$this->app->resolving(function ($object, $app) { 
// 解析 任何 类 型 的 对 象 时 都 会 调用 该 方法 .，， 
3); 
$this->app->resolving(HelpSpot\API::class, function ($api, $app) 
{ 
// 解析 [HelpSpot\APIJ」 类 型 的 对 象 时 调用 ... 
3); 
$this->app->afterResolving(function ($object, $app) { 
// PRATER RA 5E USA ARRA... 
3); 
$this->app->afterResolving(HelpSpot\API::class, function ($api, 
Sapp) { 
// fe THelpSpot\API) 类 型 的 对 象 后 调用 ,, ， 
3); 
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服务 容器 每 次 解析 对 象 的 时 候 ， 都 会 调用 这 些 通过 resolving 和 afterResolving & 
数 传 入 的 闭 包 函 数 ， 也 就 是 触发 这 些 事 件 。 注意 I 如 果 是 单 例 ， 则 只 在 解析 时 会 触 
发 一 次 


public function testResolvingCallbacksAreCalled( ) 
{ 
$container = new Container; 
$container->resolving(function ($object) { 
return $object-»name = 'taylor'; 
3): 
$container->bind('foo', function () { 
return new StdClass; 


3); 


$instance = $container->make('foo'); 


$this->assertEquals('taylor', $instance->name) ; 


public function testResolvingCallbacksAreCalledForType( ) 
{ 
$container = new Container; 
$container->resolving('StdClass', function ($object) { 
return $object-»name = 'taylor'; 
3): 
$container->bind('foo', function () { 
return new StdClass; 


3): 


$instance = $container->make('foo'); 


$this->assertEquals('taylor', $instance-»name); 
} 
public function testResolvingCallbacksShouldBeFiredwhenCalledwit 
hAliases() 
{ 
$container = new Container; 
$container->alias('StdClass', 'std'); 
$container->resolving('std', function ($object) { 
return $object-»name = 'taylor'; 
3); 
$container->bind('foo', function () { 
return new StdClass; 


3): 


$instance = $container->make('foo'); 


$this->assertEquals('taylor', $instance->name) ; 


Ww 


public function testContainerwrap( ) 


{ 


$result = $container->wrap(function (StdClass $foo, $bar = 
ODE 
return func_get_args(); 
H iL bar ->= s taylor), 


$this->assertInstanceOf('Closure', $result); 
$result = $result(); 


$this->assertInstanceOf('stdClass', $result[0]); 
$this->assertEquals('taylor', $result[1]); 


} 

public function testContainerGetFactory() 

{ 
$container = new Container; 
$container->bind('name', function () { 

return ‘Taylor’; 

DE 
$factory = $container->factory('name'); 
$this->assertEquals($container->make('name'), $factory()); 

Jj 

4-25 € a flush 


容器 的 重 置 函数 flush 会 清空 容器 内 部 的 aliases、abstractAliases、resolved ` 


bindings、instances 


public function testContainerFlushFlushesAllBindingsAliasesAndRe 
solvedInstances() 
{ 

$container = new Container; 

$container->bind('ConcreteStub', function () { 

return new ContainerConcreteStub; 
}, true); 
$container->alias('ConcreteStub', 'ContainerConcreteStub'); 


$concreteStubInstance = $container ->make('ConcreteStub'); 

$this->assertTrue($container->resolved('ConcreteStub')); 

$this->assertTrue($container ->isAlias('ContainerConcreteStub' 
)); 

$this->assertArrayHasKey('ConcreteStub', $container-»getBind 
ings()); 

$this-»assertTrue($container-»isShared( ConcreteStub')); 


$container-»flush(); 

$this->assertFalse($container ->resolved('ConcreteStub')); 

$this->assertFalse($container ->isAlias( 'ContainerConcreteStu 
b')); 

$this->assertEmpty($container ->getBindings()); 

$this->assertFalse($container ->isShared('ConcreteStub')); 


} 
加 二 一 


Written with StackEdit. 


在 前 面 几 个 博客 中 ， 我 详细 讲 了 loc 容器 各 个 功能 的 使 用 、 绑 定 的 源码 、 解 析 的 源 
码 ， 今 天 这 篇 博客 会 详细 介绍 loc 容器 的 一 些 细节 ， 一 些 特性 ， 以 便 更 好 地 掌握 容 


器 的 功能 。 


33 
ps 


注 : 本 文 使 用 的 测试 类 与 测试 对 象 都 取 自 laravel 的 单元 测试 文件 
src/illuminate/tests/Container/ContainerTest.php 


rebind 绑 定 特性 


rebind 4€ Zr Z I 

instance 和 普通 bind 绑 定 一 样 ， 当 重新 绑 定 的 时 候 都 会 调用 rebind 回调 函数 ， 但 
是 有 趣 的 是 ， 对 于 普通 bind ZR GG ^ rebind 回调 函数 被 调用 的 条 件 是 当前 接口 
被 解析 过 : 


public function testReboundListeners( ) 


{ 
unset($ SERVER[' _test.rebind']); 
$container - new Container; 
$container->rebinding('foo', function () { 
$ SERVER[' test.rebind'] = true; 
3); 
$container->bind('foo', function () { 
3); 
$container->make('foo'); 
$container->bind('foo', function () { 
3); 
$this->assertTrue($_SERVER[' test.rebind']); 
} 


所 以 遇 到 下 面 这 样 的 情况 ,rebinding 的 回调 函数 是 不 会 调用 的 : 


public function testReboundListeners() 


{ 
unset($ SERVER['__ test.rebind']); 


$container = new Container; 
$container->rebinding('foo', function () { 
$ SERVER[' test.rebind'] = true; 


3): 


$container->bind('foo', function () { 


3); 


$container->bind('foo', function () { 


3); 


$this->assertFalse(isset($_SERVER[' test.rebind'])); 


有 趣 的 是 对 于 instance AWA : 


public function testReboundListeners() 


{ 
unset($ SERVER[' _test.rebind']); 


$container - new Container; 
$container->rebinding('foo', function () { 
$ SERVER[' test.rebind'] - true; 


3); 


$container->bind('foo', function () { 


3); 


$container->instance('foo', function () { 


3); 


$this-»-assertTrue(isset($ SERVER[' ktest.rebind'])); 


rebinding 回调 郊 数 却 是 可 以 被 调用 的 。 其 实 原因 就 是 instance 源码 中 rebinding | 
调 函 数 调用 的 条 件 是 rebound 为 丨 ， 而 普通 bind HAAA rebinding 回调 函数 的 条 
件 是 resolved A. 目前 笔者 不 是 很 清楚 为 什么 要 对 instance 和 bind 区 别 对 待 ， 
希望 有 大 牛 指导 。 


rebind 在 绑 定 之 后 


为 了 使 得 rebind 回调 函数 在 下 一 次 的 绑 定 中 被 激活 ， 在 rebind 部 数 的 源码 中 ， 如 
RFI OH Say xt A CARB > BABA a Bp MAT : 


public function rebinding($abstract, Closure $callback) 


{ 
$this->reboundCallbacks[$abstract = $this->getAlias($abstrac 


t)][] = $callback; 


if ($this->bound($abstract)) ( 
return $this->make($abstract); 


单元 测试 代码 : 


public function testReboundListeners1( ) 


{ 
unset($_SERVER['_ test.rebind']); 


$container = new Container; 
$container->bind('foo', function () { 
return 'foo'; 


3): 


$container->resolving('foo', function () { 
$ SERVER[' test.rebind'] = true; 


3); 
$container-»rebinding('foo', function ($container, $object) { 
// 会 立即 解析 
$container['foobar'] = $object.'bar'; 


3): 


$this-»assertTrue($ SERVER[' test.rebind']); 


$container->bind('foo', function () { 


3): 


$this->assertEquals('bar', $container['foobar']); 


resolving 特性 


resolving 回调 的 类 型 


resolving 不 仅 可 以 针对 接口 执行 回调 函数 ， 还 可 以 针对 接口 实现 的 类 型 进行 回调 函 
数 。 


public function testResolvingCallbacksAreCalledForType( ) 
{ 
$container = new Container; 
$container->resolving('StdClass', function ($object) { 
return $object-»name = 'taylor'; 
3); 
$container->bind('foo', function () { 
return new StdClass; 


3): 


$instance = $container->make('foo'); 


$this->assertEquals('taylor', $instance->name) ; 


j 
public function testResolvingCallbacksShouldBeFiredWhenCalledWit 
hAliases() 


{ 
$container = new Container; 
$container->alias('StdClass', 'std'); 
$container->resolving('std', function ($object) ( 
return $object-»name = 'taylor'; 


3); 
$container->bind('foo', function () { 
return new StdClass; 


3); 


$instance = $container->make('foo'); 


$this->assertEquals('taylor', $instance->name) ; 


resolving 回调 与 instance 


前 面 讲 过 ， 对 于 singleton RE Kit > resolving 回调 函数 仅仅 运行 一 次 ， 只 在 
singleton 第 一 次 解析 的 时 候 才 会 调用 。 如 果 我 们 利用 instance 直接 绑 定 类 的 对 
Ro RELA > BA resolving 回调 函数 将 不 会 被 调用 : 


public function testResolvingCallbacksAreCalledForSpecificAbstra 
cts() 
{ 

$container = new Container; 

$container->resolving('foo', function ($object) { 

return $object-»name = 'taylor'; 

3); 

$obj = new StdClass; 

$container->instance('foo', $0bj); 

$instance = $container->make('foo'); 


$this->assertFalse(isset($instance->name) ); 


extend 扩展 特性 


extend 用 于 扩展 绑 定 对 象 的 功能 ， 对 于 普通 绑 定 来 说 ， 这 个 函数 的 位 置 很 灵活 : 


在 绑 定 前 扩展 


public function testExtendIsLazyInitialized() 


( 


ContainerLazyExtendStub: :$initialized = false; 


$container = new Container; 
$container ->extend('Illuminate\Tests\Container\ContainerLazy 
ExtendStub', function ($obj, $container) { 
$0bj -»init(); 
return $obj; 
3); 
$container--bind('IlluminateNTestsNContainerNContainerLazyEx 
tendStub'); 


$this->assertFalse(ContainerLazyExtendStub: :$initialized) ; 
$container-»make('IlluminateNTestsNContainerNContainerLazyEx 


tendStub'); 
$this->assertTrue(ContainerLazyExtendStub: :$initialized); 


在 绑 定 后 解析 前 扩展 


public function testExtendIsLazyInitialized() 


( 


ContainerLazyExtendStub: :$initialized = false; 


$container = new Container; 
$container ->bind( 'Illuminate\Tests\Container\ContainerLazyEx 
tendStub'); 
$container ->extend('Illuminate\Tests\Container\ContainerLazy 
ExtendStub', function ($obj, $container) { 
$0bj -»init(); 
return $0obj; 


3): 


$this->assertFalse(ContainerLazyExtendStub: :$initialized) ; 
$container ->make( 'Illuminate\Tests\Container\ContainerLazyEx 


tendStub'); 
$this->assertTrue(ContainerLazyExtendStub: :$initialized); 


在 解析 后 扩展 


public function testExtendIsLazyInitialized() 


( 


ContainerLazyExtendStub: :$initialized = false; 


$container = new Container; 
$container ->bind( 'Illuminate\Tests\Container\ContainerLazyEx 
tendStub'); 


$container ->make('Illuminate\Tests\Container\ContainerLazyEx 
tendStub'); 
$this->assertFalse(ContainerLazyExtendStub: :$initialized) ; 


$container ->extend('Illuminate\Tests\Container\ContainerLazy 
ExtendStub', function ($obj, Scontainer) f{ 
$0bj ->init(); 
return $0obj; 


3): 


$this->assertFalse(ContainerLazyExtendStub: :$initialized) ; 
$container ->make('Illuminate\Tests\Container\ContainerLazyEx 


tendStub'); 
$this->assertTrue(ContainerLazyExtendStub: :$initialized); 


可 以 看 出 ， 无 论 在 哪个 位 置 ，extend 扩展 都 有 lazy 初始 化 的 特点 ， 也 就 是 使 用 
extend 函数 并 不 会 立即 起 作用 ， 而 是 要 等 到 make 解析 才 会 激活 。 
extend 5 instance 23% 


对 于 instance 2p 3 Jb > 暂时 extend 的 位 置 需要 位 于 instance 之 后 才 会 起 作用 ， 
并 且 会 立即 起 作用 ， 没 有 lazy 的 特点 : 


public function testExtendInstancesArePreserved( ) 


{ 


$container = new Container; 


$obj = new StdClass; 

$0bj->foo = 'foo'; 

$container->instance('foo', $0bj); 

$container->extend('foo', function ($0bj, $container) { 
$obj-»bar = 'baz'; 


return $0obj; 


3): 


$this->assertEquals('foo', $container-»make('foo!')-»foo); 
$this->assertEquals('baz', $container->make('foo')->bar); 


extend 25x 5 rebind 回调 
KEY Bx Z instance HA Æ bind RE > extend 都 会 启动 rebind WA HA : 


public function testExtendReBindingInstance() 


{ 
$ SERVER[' test rebind'] = false; 


$container - new Container; 

$container->rebinding('foo',function (){ 
$ SERVER[' test rebind'] = true; 

3); 


$obj = new StdClass; 
$container->instance('foo',$obj); 


$container->make('foo'); 


$container->extend('foo', function ($0bj, $container) ( 
return $obj; 


3): 


this ->assertTrue($_SERVER[' test rebind']); 


public function testExtendReBinding( ) 


1 
$ SERVER[' test rebind'] - false; 


$container - new Container; 

$container->rebinding('foo',function (){ 
$ SERVER[' test rebind'] = true; 

3); 


$container->bind('foo',function (){ 
$obj - new StdClass; 


return $0obj; 


3); 


$container->make('foo'); 


$container->extend('foo', function ($0bj, $container) { 
return $0obj; 


3); 


this-»assertFalse($ SERVER[' test rebind']); 


contextual 绑 定 特性 


contextual 在 绑 定 前 


contextual 绑 定 不 仅 可 以 与 bind 绑 定 合作 ， 相 互 不 干扰 ， 还 可 以 与 instance A 
相互 合作 。 而 且 instance 的 位 置 也 很 灵活 ， 可 以 在 contextual HRA? WTAE 
contextual 绑 定 后 : 





Laravel Container 服务 容器 的 细节 特性 


public function testContextualBindingWorksForExistingInstancedBi 
ndings() 
{ 


$container = new Container; 


$container ->instance( 'Illuminate\Tests\Container\IContainerC 
ontractStub', new ContainerImplementationStub) ; 


$container ->when( 'Illuminate\Tests\Container\ContainerTestCo 
ntextInjectOne')-»needs('IlluminateNTestsNContainerNIContainerCo 
ntractStub' )->give('Illuminate\Tests\Container\ContainerImplemen 
tationStubTwo'); 


$this->assertInstanceOf ( 
'IlluminateNTestsNContainerNContainerImplementation 
StubTwo', 
$container-»2make('IlluminateNTestsNContainerNContai 
nerTestContextInjectOne')-»impl 


); 


contextual # #8 z & 
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Laravel Container 一 一 服务 容器 的 细节 特性 


public function testContextualBindingWorksForNewlyInstancedBindi 
ngs() 
{ 


$container = new Container; 


$container ->when( 'Illuminate\Tests\Container\ContainerTestCo 
ntextInjectOne' )->needs( 'Illuminate\Tests\Container\IContainerCo 
ntractStub' )->give('Illuminate\Tests\Container\ContainerImplemen 
tationStubTwo'); 


$container ->instance('Illuminate\Tests\Container\IContainerC 
ontractStub', new ContainerImplementationStub) ; 


$this-»assertInstanceOf( 
'IlluminateNTestsNContainerNContainerImplementationS 
tubTwo', 
$container ->make('Illuminate\Tests\Container\ContainerTe 
stContextInjectOne' )->impl 


); 


contextual #8 x 5 4 4 


contextual 绑 定 也 可 以 在 别名 上 进行 ， 无 论 赋予 别名 的 位 置 是 contextual 的 前 面 还 
是 后 面 : 


public function testContextualBindingDoesntOverrideNonContextual 
Resolution() 


( 


$container - new Container; 


$container->instance('stub', new ContainerImplementationStub 
); 

$container->alias('stub', 'Illuminate\Tests\Container\IConta 
inerContractStub' ); 


$container ->when( 'Illuminate\Tests\Container\ContainerTestCo 
ntextInjectTwo' )->needs( 'Illuminate\Tests\Container\IContainerCo 
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Laravel Containe 服务 容器 的 细节 特性 


ntractStub' )->give('Illuminate\Tests\Container\ContainerImplemen 
tationStubTwo'); 


$this->assertInstanceOf ( 
'Illuminate\Tests\Container\ContainerImplementationS 
tubTwo', 
$container ->make( 'Illuminate\Tests\Container\Contain 
erTestContextInjectTwo' )->impl 


); 


$this->assertInstanceOf ( 
'Illuminate\Tests\Container\ContainerImplementationS 
tub ' ， 
$container-»make('IlluminateNTestsNContainerNContain 
erTestContextInjectOne')-»impl 


); 


public function testContextualBindingWorksOnNewAliasedBindings() 


{ 


$container = new Container; 


$container->when('Illuminate\Tests\Container\ContainerTestCo 
ntextInjectOne')-»needs('IlluminateNTestsNContainerNIContainerCo 
ntractStub' )->give('Illuminate\Tests\Container\ContainerImplemen 
tationStubTwo'); 


$container->bind('stub', ContainerImplementationStub: :class) 


$container->alias('stub', 'Illuminate\Tests\Container\IConta 
inerContractStub'); 


$this-»assertInstanceOf( 
'IlluminateNTestsNContainerNContainerlImplementationStu 
bTwo', 
$container-»make('IlluminateNTestsNContainerNContainer 
TestContextInjectOne')-»impl 


); 
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争议 


目前 比较 有 争议 的 是 下 面 的 情况 : 


public function testContextualBindingWworksOnExistingAliasedInsta 
nces() 


{ 


$container = new Container; 


$container-»-alias('IlluminateNTestsNContainerNIContainerCont 
ractStub  '"stub'3s 
$container->instance('stub', new ContainerImplementationStub 


); 


$container ->when( 'Illuminate\Tests\Container\ContainerTestCo 
ntextInjectOne' )->needs('stub')->give('Illuminate\Tests\Containe 
r\ContainerImplementationStubTwo' ); 


$this->assertInstanceOf ( 
'Illuminate\Tests\Container\ContainerImplementationStubT 
wo', 
$container ->make('Illuminate\Tests\Container\ContainerTe 
stContextInjectOne' )->impl 


): 


由 于 instance 的 特性 ， 当 别名 被 缚 定 到 其 他 对 象 上 时 ， 别 名 stub 已 经 失去 了 与 
Illuminate\Tests\Container\IContainerContractStub 之 间 的 关系 ， 因 此 不 能 使 用 
stub 代替 作 上 下 文 绑 定 。 但 是 另 一 方面 : 


public function testContextualBindingworksOnBoundAlias() 


( 


$container - new Container; 


$container ->alias( 'Illuminate\Tests\Container\IContainerCont 
pactStub 'stub'); 
$container->bind('stub', ContainerImplementationStub: :class) 


$container ->when( 'Illuminate\Tests\Container\ContainerTestCo 
ntextInjectOne')-»needs('stub')-»give('IlluminateNTestsNContaine 
r\ContainerImplementationStubTwo' ); 


$this-»assertInstanceOf( 
'IlluminateNTestsNContainerNContaineriImplementationStubT 
wo', 
$container-»make('IlluminateNTestsNContainerNContainerTe 
stContextInjectOne' )->impl 


); 


代码 只 是 从 instance HERAA bind RE > AF bind 绑 定 只 切断 了 别名 中 的 alias 
数组 的 联系 ， 并 没有 断绝 abstractAlias 数 组 的 联系 ， 因 此 这 段 代码 却 可 以 通过 ， 很 
让 人 难以 理解 。 本 人 在 给 Taylor Otwell 提出 PR 时 ， 作 者 原 话 为 中 m not making 
any of these changes to the container on a patch release.”。 也 许 ， 在 2 
VAJ& RAE EAE Gp ix EDGE f RRT VÉ ARA Gu S E 5 

大 家 也 最 好 不 要 这 样 用 。 


服务 容器 中 的 闭 包 函数 参数 


务 容 器 中 很 多 函数 都 有 闭 包 函数 ， 这 些 闭 包 函 数 可 以 放 入 特定 的 参数 ， 在 绑 定 或 
孚 析 过 程 中 ， 这 些 参数 会 被 服务 容器 自动 带 入 各 种 类 对 象 或 者 服务 容器 实例 。 


public function testAliasesWithArrayOfParameters() 


{ 

$container = new Container; 

$container->bind('foo', function ($app, $config) ( 

return $config; 

3); 

$container->alias('foo', 'baz'); 

$this-»-assertEquals([1, 2, 3], $container->makeWith('baz', [1 
, 2, 3))); 
y 


dj c—————————————————————s———À9Ü ae[ 


extend 闭 包 参数 


public function testExtendedBindings( ) 


{ 
$container = new Container; 
$container['foo'] = 'foo’; 
$container->extend('foo', function ($old, $container) { 
return $old.'bar’; 
3): 
$this->assertEquals('foobar', $container->make('foo')); 
$container = new Container; 
$container->singleton('foo', function () { 
return (object) ['name' => 'taylor']; 
3); 
$container->extend('foo', function ($0old, $container) ( 
$old->age = 26; 
return $old; 
3); 
$result = $container->make('foo'); 
$this->assertEquals('taylor', $result->name); 
$this->assertEquals(26, $result->age); 
$this->assertSame($result, $container->make('foo')); 
} 


bindmethod 闭 包 参数 


public function testCallwithBoundMethod() 
{ 
$container = new Container; 
$container-»-bindMethod('IlluminateNTestsNContainerNContainer 
TestCallStub@unresolvable', function ($stub,$container) { 
$container['foo'] = 'foo'; 
return $stub->unresolvable('foo', 'bar'); 
3); 
$result = $container ->call('Illuminate\Tests\Container\Conta 
inerTestCallStub@unresolvable' ); 
$this->assertEquals(['foo', 'bar'], $result); 
$this->assertEquals('foo',$container['foo']); 


resolve 闭 包 参数 

public function testResolvingCallbacksAreCalledForSpecificAbstra 
CESC) 

{ 


$container = new Container; 
$container->resolving('foo', function ($object > $container) 


return $object->name = 'taylor'; 


}); 


$container->bind('foo', function () { 
return new StdClass; 


3): 


$instance = $container->make('foo'); 


$this->assertEquals('taylor', $instance-»name); 


} 
i 


N 


rebinding 闭 包 参数 


public function testReboundListeners() 


{ 
$container = new Container; 
$container->bind('foo', function () { 
return 'foo'; 


3); 
$container->rebinding('foo', function ($container,$object) { 
$container['bar'] = $object.'bar'; 


3); 


$container->bind('foo', function () { 


3): 


$this->assertEquals('bar',$container['foobar']); 


作为 一 个 web 后 台 框架 ， 路 由 无 疑 是 极其 重要 的 一 部 分 。 本 博客 接 下 来 几 篇 文章 者 
将 会 围绕 路 由 这 一 主题 来 展开 讨论 ， 分 别 讲述 : 


e 路 由 的 使 用 

e 路 由 属性 注册 

e 路 由 的 正则 编译 与 匹配 
e 路 由 的 中 间 件 

e 路 由 的 控制 器 与 参数 绑 定 
e RESTful 路 由 


和 之 前 一 样 ， 第 一 篇 将 会 利用 单元 测试 样 例 说 明 我 们 在 平时 可 能 用 到 的 route 的 
api HAA Š > 6 da JUR SC 3E 3E 2-91 9f laravel 的 route 源码 。 下 面 开始 介绍 laravel 
中 路 由 的 各 种 用 法 。 


路 由 属性 注册 


所 有 Laravel 路 由 都 定义 在 位 于 routes 目录 下 的 路 由 文件 中 ， 这 些 文件 通过 框架 自 
动 加 载 。routes/web.php 文件 定义 了 web 界面 的 路 由 ， 这 些 路 由 被 分 配 了 web 中 
间 件 组 ， 从 而 可 以 提供 session 和 csrf 防护 等 功能 。routes/api.php 中 的 路 由 是 无 
状态 的 ， 被 分 配 了 api 中 间 件 组 。 


对 大 多 数 应 用 而 言 ， 都 是 从 routes/web.php 文件 开始 定义 路 由 。 


路 由 method 方法 


我 们 可 以 注册 路 由 来 响应 任何 HTTP 请 求 : 


Route::get($uri, $callback); 
Route: :post($uri, $callback); 
Route: :put($uri, $callback); 
Route: :patch($uri, $callback); 
Route: :delete($uri, $callback); 
Route: :options($uri, $callback); 





有 时 候 还 需要 注册 路 由 响应 多 个 HTTP 请 求 这 可 以 通过 match 方法 来 实 
现 。 或 者 ， 可 以 使 用 any 方法 注册 一 个 路 由 来 响应 所 有 HTTP AR: 


Route::match(['get', 'post'], '/', function () { 


PFE 


3); 


Route::any('foo', function () ( 


Y 


I) 


值得 注意 的 是 ， 一 般 的 HTML 表 单 仅 仅 支持 get ^ post ， 并 不 支 
持 put ^ patch ^ delete 等 动作 ， 这 时 候 就 需要 在 前 端 添加 一 个 隐藏 的 
_method 字段 到 给 表单 中 ， 其 值 被 用 作 HTTP 请 求 方法 名 : 


<input type="hidden" name="_method" value="PUT"> 


在 web 路 由 文件 中 所 有 请 求 方式 为 PUT ^ POST 或 DELETE 的 HTML 表单 都 会 
包含 一 个 CSRF 令 牌 字段 ， 否 则 ， 请 求 会 被 拒绝 。 关 于 CSRF 的 更 多 细节 ， 可 以 
参考 浅 谈 CSRF 攻 击 方式 : 


<form method="POST" action="/profile"> 
{{ csrf_field() }} 


</form> 


路 由 Scheme 协议 


对 于 web 后 台 框 架 来 说 ， 路 由 的 scheme 底层 协议 一 般 使 用 http ^ https : 


Route::get('foo/{bar}', ['http', function () { 


31); 
Route::get('foo/(bar)', ['https', function () { 


31); 


路 由 domain 子 域名 


子 域名 可 以 像 URI 一 样 被 分 配给 路 由 参数 ， 子 域名 可 以 通过 路 由 属性 中 的 
domain 来 指定 : 


Route: :domain('api.name.bar' ) 
->get('foo/bar', function ($name) ( 
return $name; 


3): 


Route::get('foo/bar', ['domain' => 'api.name.bar', function ($na 


me) { 


return $name; 


31; 


路 由 prefix 前 级 
可 以 为 路 由 添加 一 个 给 定 URI 前 级， 通过 利用 路 由 属性 的 prefix 指定 : 


Route: :prefix('pre') 
->get('foo/bar', function () { 
3); 


Route::get('foo/bar', ['prefix' => 'pre', function () { 


31); 


Route::get('foo/bar', function () ( 
})->prefix('pre'); 


路 由 where 正则 约束 
可 以 为 路 由 的 URI 参数 指定 正则 约束 : 


Route::get('{one}', ['where' => ['one' => '(.+)'], function () { 


31); 


Route::get('fone?', function () { 
J)-?where('one', '(.*)'); 


如 果 想 要 路 由 参数 在 全 局 范围 内 被 给 定 正则 表达 式 约束 ， 可 以 使 用 pattern 7 
法 。 在 RouteServiceProvider 类 的 boot 方法 中 定义 约束 模式 : 

public function boot() 

{ 


Route: :pattern('one', '(.+)'); 
parent: :boot(); 


%% middleware ¥ Ij 4t 
为 路 由 添加 中 间 件 ， 通 过 利用 路 由 属性 的 middleware 指定 : 
Route: :middleware('web') 
->get('foo/bar', function () { 


3): 


Route::get('foo/bar', ['middleware' => 'web', function () { 


31); 


Route::get('foo/bar', function () { 
})->middleware('web'); 


路 由 namespace 属性 


可 以 为 路 由 的 控制 器 添加 namespace 来 指定 控制 器 的 命名 空间 : 


Route: :namespace( 'Namespace\\Example\\' ) 
->get('foo/bar', function () { 


3): 


Route::get('foo/bar', ['namespace' -» 'NamespaceNNExampleNN', fu 
petdoms et 


31); 


路 由 uses 属性 
可 以 为 路 由 添加 URI 对 应 的 执行 逻辑 ， 例 如 闭 包 或 者 控制 器 : 


Route::get('foo/bar', ['uses' => function () { 


31); 


Route::get('foo/bar', ['uses' => 'IlluminateNTestsNRoutingNRoute 
TestControllerStubQindex']); 


Route::get('foo/bar')->uses(function () { 


3); 


Route::get('foo/bar')-»uses('IlluminateNTestsNRoutingNRouteTestC 
ontrollerStubQindex'); 


路 由 as 别名 


可 以 为 路 由 指定 别名 ， 通 过 路 由 属性 的 as 来 指定 : 


Route::as('Foo') 
->get('foo/bar', function () { 
3); 


Route: :name('Foo' ) 
->get('foo/bar', function () { 


3): 


Route::get('foo/bar', ['as' => 'Foo', function () { 


31; 


Route::get('foo/bar', function () { 
})->name('Foo'); 


X% group 群 组 属性 


可 以 为 一 系列 具有 类 似 属 性 的 路 由 归 为 同一 组 ， 利 用 group 将 这 些 路 由 归并 到 一 
起 : 


Route: :group(['domain' => 'group.domain.name', 
'prefix' => 'grouppre', 
'where' => ['one' => '(.+)'], 
'middleware' => 'groupMiddleware', 
'namespace' => 'Namespace\\Group\\', 
fasi => 'Group::', ] 


funetion () f 
Route::get('/replace','domain' -» 'route.domai 
n.name' » 
'uses' -» function () 


return 'replace'; 
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Route: :get('additional/{one}/{two}', 'prefix' 
=> 'routepre', 
'where' 
=> '['one' => '([0-9]*)','two' => '(.*)']', 
'middlewar 


e' => 'routeMiddleware', 


'namespace' 
=> 'Namespace\\Group\\', 
D 
-» 'Route', 
'use 


=> 'function () { 
return 'ad 
ditional'; 
3); 
3); 


$this->assertEquals('replace', $router->dispatch(Request: :create( 
'http://route.domain.name/grouppre/replace', 'GET'))->getContent 


()); 


$this->assertEquals('additional', $router->dispatch(Request::cre 
ate('http://group.domain.name/routepre/grouppre/additional/111/a 
dd', 'GET'))-»getContent( )); 


$routes = $router->getRoutes()->getRoutes(); 

$action = $routes[9]-»getAction(); 

$this->assertEquals( 'Namespace\\Group\\', $action[ 'namespace']); 
$this->assertEquals('Group::', $action['as']); 


$routes = $router->getRoutes()->getRoutes(); 

$action = $routes[1]-»getAction(); 
$this->assertEquals(['groupMiddleware', 'routeMiddleware'], $act 
ion['middleware']); 

$this->assertEquals( 'Namespace\\Group\\Namespace\\Group\\', $act 
ion[ 'namespace']); 

$this->assertEquals('Group::Route', $action['as']); 


ee | 


group 群 组 的 属性 分 为 两 类 : 替换 型 、 递 增 型 。 当 群 组 属性 与 路 由 属性 重复 的 时 
候 ， 和 替换 型 属性 会 用 路 由 的 属性 替换 群 组 的 属性 ， 递 增 型 的 属性 会 综合 路 由 和 和 群 组 
的 属性 。 


在 上 面 的 例子 可 以 看 出 : 


e domain 这 个 属性 是 替换 型 属性 ， 路 由 的 属性 会 覆盖 和 替换 群 组 的 这 几 个 必 
性 ; 

e prefix ^ middleware ^ namespace ^ as ^ where 这 几 个 属性 是 递 
增 型 属性 ， 路 由 的 属性 和 和 群 组 属性 会 相互 结合 。 


另外 值得 注意 的 是 : 


e 路 由 的 prefix 属性 具有 优先 级 ,因此 上 面 第 二 个 路 由 的 uri X 
routepre/grouppre/additional/111/add ,而 不 是 
grouppre/routepre/additional/111/add : 

e where 属性 对 于 相同 的 路 由 参数 会 替换 ， 不 同 的 路 由 参数 会 结合 ， 因 此 上 面 
where 中 one RẸ i> two 被 结合 进来 


路 由 参数 与 匹配 


laravel 允许 在 注册 定义 路 由 的 时 候 设 定 路 由 参数 ， 以 供 器 或 者 闭 包 所 用 。 路 由 
参数 可 以 设 定 在 URI 中 ， 也 可 以 设 定 在 ”domain M 


路 由 编码 匹配 


对 于 已 编码 的 请 求 URI ， 框 架 会 自动 进行 解码 然后 进行 匹配 : 


$router = $this->getRouter(); 
$router->get('foo/bar/aad', function () ( 
return 'hello'; 
3); 
$this->assertEquals('hello', $router->dispatch(Request::create(' 
foo/bar/%C3%A5%CE%B1%D1%84', 'GET'))->getContent()); 


$router = $this->getRouter(); 
$route = $router->get('foo/{file}', function ($file) { 
return $file; 
3); 
$this->assertEquals( 'oxygen%20', $router->dispatch(Request: :crea 
te('http://test.com/foo/oxygen%2520', 'GET'))->getContent()); 
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符 ， 需 要 的 话 可 以 使 用 _ 替代。 


$router = $this->getRouter(); 
$route = $router->get('foo/{age}', ['domain' => 'api.{name}.bar' 
, function ($name, $age) { 

return $name. $age; 
31); 
$this->assertEquals('taylor25', $router->dispatch(Request::creat 
e('http://api.taylor.bar/foo/25', 'GET'))->getContent()); 


$route = new Route('GET', 'images/{id}.{ext}', function () { 
3); 


$request1 = Request::create('images/1.png', 'GET'); 
$this-»-assertTrue($route-»matches($request1)); 
$route-»bind($request1); 
$this->assertTrue($route->hasParameter('id')); 
$this->assertFalse($route->hasParameter('foo')); 
$this->assertEquals('1', $route->parameter('id')); 
$this->assertEquals('png', $route->parameter('ext')); 


路 由 可 选 参数 


有 时 候 可 能 需要 指定 可 选 的 路 由 参数 ， 这 可 以 通过 在 参数 名 后 加 一 个 ? 标记 来 实 
现 ， 这 种 情况 下 需要 给 相应 的 变量 指定 默认 值 : 


$router = $this->getRouter(); 
$router->get('{fo00?}/{baz?}', function ($name = 'taylor', $age = 
25) 

return $name. $age; 


}); 


$this->assertEquals('fred25', $router->dispatch(Request::create( 
'fred', 'GET'))->getContent()); 


$router->get('default/{foo?}/{baz?}', function ($name, $age = 25) 
{ 


return $name. $age; 
})->default('name', 'taylor'); 
$this->assertEquals('fred25', $router->dispatch(Request::create( 
'fred', 'GET'))->getContent()); 


El — E 


路 由 参数 正则 约束 


可 以 使 用 路 由 实例 上 的 where 方法 来 约束 路 由 参数 的 格式 。 where 方法 接收 参 
数 名 和 一 个 正则 表达 式 来 定义 该 参数 如 何 被 约束 : 


Route::get('user/{name}', function ($name) ( 
YAH 
})->where('name', '[A-Za-z]+'); 


如 果 想 要 路 由 参数 在 全 局 范围 内 被 给 定 正则 表达 式 约束 ， 可 以 使 用 pattern Z7 
法 。 在 RouteServiceProvider 类 的 boot 方法 中 定义 约束 模式 : 


pubie Tunecrtzon boot) 


{ 
Route::pattern('id', '[0-9]+'); 
parent: :boot(); 


值得 注意 的 是 ， 路 由 参数 是 不 允许 出 现 / 字符 的 ， 例 如 : 


$router->get('{one?}', [ 
'uses' => function ($one = null)( 
return $one; 
tr 
1); 
$request = Request::create('foo/bar/baz', 'GET'); 
$this->assertFalse($route->matches($request2) ); 


上 例 中 one 只 能 匹配 foo ， 不 能 匹配 foo/bar/baz ,这 时 就 需要 对 one 3t 
行 正 则 约束 : 


public function testLeadingParamDoesntReceiveForwardSlashOnEmpty 
Path() 


{ 
$router = $this->getRouter(); 
$router->get('{one?}', [ 
"uses' => function ($one = null)( 
return $one; 


ty 
'where' => ['one' => '(.+)'], 


1); 


$this->assertEquals('foo', $router->dispatch(Request: :create( 
'/foo', 'GET'))->getContent()); 

$this->assertEquals('foo/bar/baz', $router->dispatch(Request 
:create('/foo/bar/baz', 'GET'))->getContent()); 
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路 由 中 间 件 


HTTP 中 间 件 为 过 滤 进 入 应 用 的 HTTP 请 求 提供 了 一 套 便利 的 机 制 。 例 如 ，Laravel 
内 置 了 一 个 中 间 件 来 验证 用 户 是 否 经 过 认证 ， 如 果 用 户 没有 经 过 认证 ， 中 间 件 会 将 
用 户 重 定向 到 登录 页 面 ， 否 则 如 果 用 户 经 过 认证 ， 中 间 件 就 会 允许 请 求 继续 往 前 进 
ACIEM S 


Laravel 框 架 自 带 了 一 些 中 间 件 ， 包 括 认 证 、CSRF 保护 中 间 件 等 等 。 所 有 的 中 间 件 
都 位 于 app/Http/Middleware 目录 。 


中 间 件 之 前 /之 后 /终止 


一 个 中 间 件 是 请 求 前 还 是 请 求 后 执行 取决 于 中 间 件 本 身 。 比 如 ， 以 下 中 间 件 会 在 请 
求 处 理 前 执行 一 些 任务 : 


class BeforeMiddleware 


{ 
public function handle($request, Closure $next) 
{ 
// 执行 动作 
return $next($request); 
} 
} 
class AfterMiddleware 
{ 
public function handle($request, Closure $next) 
{ 
$response = $next($request); 
// 执行 动作 
return $response; 
} 
} 
有 时 候 中 间 件 可 能 需要 在 HTTP 响应 发 送 到 浏览 器 之 后 做 一 些 工作 。 比 如 ， 


Laravel 内 置 的 session" 中 间 件 会 在 响应 发 送 到 浏览 器 之 后 将 ， Session 数据 写 到 存 
储 器 中 ， 为 了 实现 这 个 功能 ， 需 要 定义 一 个 终止 中 间 件 并 添加 terminate 方法 到 这 
个 中 间 件 : 


class StartSession 


{ 
public function handle($request, Closure $next) 
{ 
return $next($request ); 
} 
public function terminate($request, $response) 
{ 
// 存储 session 数据 ,, ， 
} 
} 


全 局 中 间 件 


如 果 你 想 要 中 间 件 在 每 一 个 HTTP 请 求 期 间 被 执行 ， 只 需要 将 相应 的 中 间 件 类 设置 
到 app/Http/Kernel.php 的 数组 属性 $middleware 中 即 可 。 


protected $middleware = [ 
NIlluminateNFoundationNHttpNMiddlewareNCheckForMaintenan 
ceMode::class, 
NIlluminateNFoundationNHttpNMiddlewareNValidatePostSize: 
:class, 
\App\Http\Middleware\TrimStrings::class, 
\Illuminate\Foundation\Http\Middleware\ConvertEmptyStrin 
gsTONull::class, 


1; 


路 由 中 间 件 


如 果 你 想 要 分 配 中 间 件 到 指定 路 由 ， 可 以 传递 完整 的 类 名 : 


use App\Http\Middleware\CheckAge; 


Route::get('admin/profile', function () { 
jy 
))-»middleware(CheckAge::class); 


或 者 可 以 给 中 间 件 提供 一 个 别名 : 


public function testDefinedClosureMiddleware( ) 


{ 
$router = $this->getRouter(); 
$router->get('foo/bar', ['middleware' => 'foo', function () 


return 'hello'; 


31); 
$router->aliasMiddleware('foo', function ($request, $next) { 
return 'caught'; 


3); 
$this->assertEquals('caught', $router->dispatch(Request::cre 
ate('foo/bar', 'GET'))->getContent()); 


} 


也 可 以 应 该 在 app/Http/Kernel.php 文件 中 分 配给 该 中 间 件 一 个 key > RU 
情况 下 ， 该 类 的 $routeMiddleware 属性 包含 了 Laravel 自 带 的 中 间 件 ， 要 
添加 你 自己 的 中 间 件 ， 只 需要 将 其 追加 到 后 面 并 为 其 分 配 一 个 key ， 例 如 : 


protected $routeMiddleware = [ 
‘auth! => \Illuminate\Auth\Middleware\Authenticate: :class, 
‘auth. basic' => \Illuminate\Auth\Middleware\Authenticatewith 


BasicAuth::class, 

‘bindings! => \Illuminate\Routing\Middleware\SubstituteBindi 
ngs::class, 

‘can! => \Illuminate\Auth\Middleware\Authorize::class, 

'guest' => \App\Http\Middleware\RedirectIfAuthenticated::cla 
ss, 

'throttle' => \Illuminate\Routing\Middleware\ThrottleRequest 
s::class, 


Route::get('admin/profile', function () { 
// 
})->middleware('auth'); 


使 用 数组 分 配 多 个 中 间 件 到 路 由 : 


Route::get('/', function () { 
Le 
})->middleware('first', 'second'); 


中 间 件 组 


SI uS EM ee eee Us eee eee 
更 方便 将 其 分 配 到 路 由 中 ， 这 可 以 通过 使 用 HTTP Kernel 的 
$middlewareGroups 属性 实现 。 


Laravel 自 带 了 开 箱 即 用 的 web 和 api 两 个 中 间 件 组 以 分 别 包 含 可 以 应 用 
到 web UI 和 API 路 由 的 通用 中 间 件 : 


protected $middlewareGroups = [ 
'web' => [ 
\App\Http\Middleware\EncryptCookies::class, 
NIlluminateNCookieNMiddlewareNAddQueuedCookiesToResponse 
::Class, 
\Illuminate\Session\Middleware\StartSession::class, 
NIlluminateNViewNMiddlewareNShareErrorsFromSession::clas 


NAppNHttpNMiddlewareNVerifyCsrfToken::class, 
NIlluminateNRoutingNMiddlewareNSubstituteBindings::class 


], 


'api' => [ 
"throttle:09, 1; 
rauch ania, 

], 

l; 


Route::get('/', function () { 


of, 


})->middleware('web'); 
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public function testMiddlewareGroupsCanReferenceOtherGroups( ) 


{ 
unset($ SERVER[' middleware.group']); 


$router = $this->getRouter(); 
$router->get('foo/bar', ['middleware' => 'web', function () 


return 'hello'; 


31); 


$router->aliasMiddleware('two', 'IlluminateNTestsNRoutingNRo 
utingTestMiddlewareGroupTwo'); 

$router->middlewareGroup('first', ['two:abigail']); 

$router->middlewareGroup('web', ['Illuminate\Tests\Routing\R 
outingTestMiddlewareGroupOne', 'first']); 


$this->assertEquals('caught abigail', $router->dispatch(Requ 
est::create('foo/bar', 'GET'))->getContent()); 
$this-»assertTrue($ SERVER[' middleware.group']); 


unset($ SERVER[' middleware.group']); 


中 间 件 参数 


中 间 件 还 可 以 接收 额外 的 自 定义 参数 ， 例 如， 如 果 应 用 需要 在 执行 给 定 动作 之 前 验 
证 认证 用 户 是 否 拥 有 指定 的 角色 ， 可 以 创建 一 个 CheckRole 来 接收 角色 名 作为 
额外 参数 。 


额外 的 中 间 件 参数 会 在 $next 参数 之 后 传 入 中 间 件 : 


namespace App\Http\Middleware; 
use Closure; 


class CheckRole 


{ 
public function handle($request, Closure $next, $role) 
{ 
if (! $request->user()->hasRole($role)) { 
// Redirect... 
} 
return $next($request); 
} 
} 


Route: :put('post/{id}', function ($id) { 
GE 
})->middleware('role:editor'); 


中 间 件 的 顺序 


当 router 中 有 多 个 中 间 件 的 时 候 ， 中 间 件 的 执行 顺序 并 不 是 严格 按照 中 间 件 数 
组 进行 的 ， 框 架 中 存在 一 个 数组 $middlewarePriority ,规定 了 这 个 数组 中 各 个 
中 间 件 的 顺序 : 


protected $middlewarePriority = [ 
NIlluminateNSessionNMiddlewareNStartSession::class, 
NIlluminateNViewNMiddlewareNShareErrorsFromSession::clas 


NIlluminateNAuthNMiddlewareNAuthenticate::class, 
\Illuminate\Session\Middleware\AuthenticateSession: :clas 


NIlluminateNRoutingNMiddlewareNSubstituteBindings::class 


NIlluminateNAuthNMiddlewareNAuthorize::class, 
]; 


当 我 们 使 用 了 上 面 其 中 多 个 中 间 件 的 时 候 ， 框 架 会 自动 按照 上 面 的 数组 进行 排序 : 


public function testMiddlewarePrioritySorting( ) 
{ 
$middleware = [ 

Placeholderi::class, 
SubstituteBindings::class, 
Placeholder2::class, 
Authenticate::class, 
Placeholder3::class, 


]; 
$router = $this->getRouter(); 


$router->middlewarePriority = [Authenticate::class, Substitu 
teBindings::class, Authorize::class]; 


$route = $router->get('foo', ['middleware' => $middleware, ' 
uses' => function ($name) { 
return $name; 


31); 


$this-»assertEquals([ 
Placeholderi::class, 
Authenticate::class, 
SubstituteBindings::class, 
Placeholder2::class, 
Placeholder3::class, 

], $router->gatherRouteMiddleware($route) ); 
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更 普遍 的 方法 是 使 用 控制 器 来 组 织 管理 这 些 行为 。 控 制 器 可 以 将 相关 的 HTTP 请 
求 封装 到 一 个 类 中 进行 处 理 。 通 常 控制 器 存放 在 app/Http/Controllers 目录 


ig 


所 有 的 Laravel 控制 器 应 该 继承 自 Laravel 自 带 的 控制 器 基 类 Controller ， 控 制 
器 基 类 提供 了 一 些 很 方便 的 方法 如 middleware ， 用 于 添加 中 间 件 到 控制 器 动 
AE : 


class UserController extends Controller 


{ 


public function show($id) 


{ 


return view('user.profile', ['user' => User::findOrFail( 
$id)]); 
j 


Route::get('user/{id}', 'UserControllerQshow'); 


单 动作 控制 器 


如 果 想 要 定义 一 个 只 处 理 一 个 动作 的 控制 器 ， 可 以 在 这 个 控制 器 中 定义 invoke 
方法 , 当 为 这 个 单 动作 控制 器 注册 路 由 的 时 候 ， 不 需要 指定 方法 : 


public function testDispatchingCallableActionClasses() 


{ 
$router = $this->getRouter(); 
$router->get('foo/bar', 'Illuminate\Tests\Routing\ActionStub' 


); 


$this->assertEquals('hello', $router->dispatch(Request: :crea 
te('foo/bar', 'GET'))->getContent()); 


$router->get('foo/bar2', [ 
'uses' => 'IlluminateNTestsNRoutingNActionStubQfunc', 


]); 


$this->assertEquals('hello2', $router->dispatch(Request::cre 
ate('foo/bar2', 'GET'))->getContent()); 


} 
class ActionStub extends Controller 
{ 

public function __invoke() 

if 

return 'hello'; 

} 

} 
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器 中 间 件 


将 中 间 件 放 在 控制 器 构造 函数 中 更 方便 ， 在 控制 器 的 构造 函数 中 使 用 middleware 
方法 你 可 以 很 轻松 的 分 配 中 间 件 给 该 控制 器 。 你 其 至 可 以 限定 该 中 间 件 应 用 到 该 控 
制 器 类 的 指定 方法 : 


class UserController extends Controller 


{ 
public function X construct() 
t 
$this-»middleware( 'auth'); 
$this->middleware('log')->only('index'); 
$this->middleware('subscribed')->except('store'); 
} 
} 


callAction 方法 
值得 注意 的 是 每 次 执行 控制 器 方法 都 会 先 执行 控制 器 的 callAction 函数 : 


public function callAction($method, $parameters) 


{ 





return call_user_func_array([$this, $method], $parameters); 


测试 样 例 : 
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unset($ SERVER[' test.controller_callAction_parameters']); 

$router->get(($str = str_random()).'/{one}/{two}', 'Illuminate\T 
ests\Routing\RouteTestAnotherControllerwithParameterStub@oneArgu 

ment'); 

$router->dispatch(Request: :create($str.'/one/two', 'GET')); 
$this->assertEquals(['one' => 'one', 'two' => 'two'], $ SERVER[ 
' test.controller callAction parameters']); 


class RouteTestAnotherControllerwithParameterStub extends Contro 
ller 
{ 


public function callAction($method, $parameters) 


{ 
$ SERVER[' test.controller_callAction_parameters'] = $p 


arameters; 


} 
public function oneArgument($one) 
{ 
} 
} 
call% ;& 


~ 


和 普通 类 一 样 ， 若 控制 器 中 没有 对 应 classname@method 中 的 method , 则 会 调 
用 类 的 — call Hee 


— 
oo 
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public function testCallableControllerRouting() 
{ 


$router = $this->getRouter(); 


$router->get('foo/bar', 'IlluminateNTestsNRoutingNRouteTestC 
ontrollerCallableStub@bar'); 

$router->get('foo/baz', 'IlluminateNTestsNRoutingNRouteTestC 
ontrollerCallableStub@baz'); 


$this->assertEquals('bar', $router->dispatch(Request: :create( 
'foo/bar', 'GET'))->getContent()); 

$this->assertEquals('baz', $router->dispatch(Request: :create( 
'foo/baz', 'GET'))->getContent()); 
} 


class RouteTestControllerCallableStub extends Controller 


{ 
public function __call($method, $arguments = []) 


{ 


return $method; 


路 由 参数 依赖 注入 与 绑 定 
Laravel 使 用 服务 容器 解析 所 有 的 Laravel 控制 器 ， 因 此 ， 可 以 在 控制 器 的 构造 函数 


中 类 型 声明 任何 依赖 ， 这 些 依赖 会 被 自动 解析 并 注入 到 控制 器 实例 中 。 路 由 的 参数 
绑 定 可 以 分 为 两 种 : 显示 绑 定 与 隐 示 绑 定 。 
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e 控制 器 方法 期 望 输入 路 由 参数 ， 只 需要 将 路 由 参数 放 到 其 他 依赖 之 后 


Route: :put('user/{id}', 'UserController@update' ); 


class UserController extends Controller 


{ 
public function update(Request $request, $id) 
{ 
} 

} 


e 可 以 在 控制 器 的 动作 方法 中 进行 依赖 的 类 型 提示 ， 例 如 ， 我 们 可 以 在 某 个 方法 
中 类 型 提示 IlluminateMittpNRequest 实例 : 


class UserController extends Controller 


{ 
public function store(Request $request) 
{ 
$name = $request->input('name'); 
j 
} 


e 可 以 为 控制 器 的 动作 方法 中 添加 数据 库 模 型 的 主键 ， 框 架 会 自动 利用 主键 来 获 
取 对 应 的 记录 ， 需 要 注意 的 是 ，route 定 义 路 由 的 路 由 参数 必须 和 控制 器 内 的 变 
量 名 相同 ， 例 如 下 例 中 路 由 参数 userid 和 控制 器 参数 userid : 


Route::put('user/{userid}', 'UserController@update' ); 


class UserController extends Controller 


{ 
public function update(UserModel $userid) 
{ 
$userid->name = 'taylor'; 
$userid->update(); 
} 
} 


综合 测试 样 例 : 
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public function testImplicitBindingsWithOptionalParameter() 
{ 
unset($ SERVER['__test.controller_callAction parameters']); 
$router->get(($str = str_random()).'/{user}/{defaultNull?}/{ 
team?}', [ 
'middleware' => SubstituteBindings::class, 
'uses' => 'IlluminateNTestsNRoutingNRouteTestAnotherCont 
rollerwithParameterStubQwithModels', 


]); 


$router->dispatch(Request::create($str.'/1', 'GET')); 


$values = array values($ SERVER[' test.controller_callActio 
n parameters']); 


$this->assertInstanceOf( 'Illuminate\Http\Request', $values[O 
1); 

$this->assertEquals(i, $values[i]->value); 

$this->assertNull($values[2]); 

$this->assertInstanceOf( 'Illuminate\Tests\Routing\RoutingTes 
tTeamModel', $values[3]); 


} 


class RouteTestAnotherControllerwithParameterStub extends Contro 
ller 
1 


public function callAction($method, $parameters) 
i 
$ SERVER[' test.controller callAction parameters'] = $p 
arameters; 


j 


public function withModels(Request $request, RoutingTestUser 
Model $user, $defaultNull - null, RoutingTestTeamModel $team - n 
ull) 

{ 

} 
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class RoutingTestUserModel extends Model 


{ 


public function getRouteKeyName( ) 


{ 
return 'id'; 
} 
public function where($key, $value) 
{ 
$this->value = $value; 
return $this; 
} 
public function Tirst() 
{ 
return $this; 
} 
public function TicstOreail() 
t 
return $this; 
J 


class RoutingTestTeamModel extends Model 


{ 


public function getRouteKeyName( ) 


t 
return 'id'; 
} 
public function where($key, $value) 
{ 
$this->value = $value; 
return $this; 
} 
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public function first() 


t 
return $this; 
} 
public function firstOrFail() 
{ 
return $this; 
J 


路 由 显示 绑 定 


除了 隐 示 地 转化 路 由 参数 外 ， 我 们 还 可 以 给 路 由 参数 显示 提供 绑 定 。 显 示 绑 定 有 
bind 、 model 两 种 方法 。 


e 通过 bind 为 参数 绑 定 闭 包 函 数 : 


public function testRouteBinding() 
{ 
$router = $this->getRouter(); 
$router->get('foo/{bar}', ['middleware' => SubstituteBinding 
s::class, 'uses' => function ($name) { 
return $name; 
31); 
$router->bind('bar', function ($value) ( 
return strtoupper ($value); 
}); 
$this->assertEquals('TAYLOR', $router->dispatch(Request::cre 
ate('foo/taylor', 'GET'))->getContent()); 
} 


e 通过 bind 为 参数 绑 定 类 方法 ， 可 以 指定 classname@method ， 也 可 以 直 
接 使 用 类 名 ， 默 认 会 调用 类 的 bind BA: 


public function testRouteClassBinding( ) 
{ 

$router = $this->getRouter(); 

$router->get('foo/{bar}', ['middleware' => SubstituteBinding 
s::class, 'uses' => function ($name) { 

return $name; 

31); 

$router->bind('bar', 'IlluminateNTestsNRoutingNRouteBindingS 
tub'); 

$this->assertEquals('TAYLOR', $router->dispatch(Request::cre 
ate('foo/taylor', 'GET'))->getContent()); 
} 


public function testRouteClassMethodBinding( ) 
{ 

$router = $this->getRouter(); 

$router->get('foo/{bar}', ['middleware' => SubstituteBinding 
s::class, 'uses' => function ($name) { 

return $name; 

31); 

$router->bind('bar', 'IlluminateNTestsNRoutingNRouteBindingS 
tub@find'); 

$this->assertEquals('dragon', $router->dispatch(Request::cre 
ate('foo/Dragon', 'GET'))->getContent()); 


} 
class RouteBindingStub 
{ 
public function bind($value, $route) 
{ 
return strtoupper($value); 
} 
public function find($value, $route) 
{ 
return strtolower($value); 
} 


过 model 为 参数 绑 定 数据 库 模型 ， 路 由 的 参数 就 不 需要 和 控制 器 方法 中 的 


变量 名 相同 ， laravel 会 利用 路 由 参数 的 值 去 调用 where 方法 查找 对 应 记 


Sy Gh E 


if ($model = $instance->where($instance->getRouteKeyName(), $val 
ue)->first()) { 
return $model; 


测试 样 例 如 下 : 


public function testModelBinding( ) 
{ 

$router = $this->getRouter(); 

$router->get('foo/{bar}', ['middleware' => SubstituteBinding 
s::class, 'uses' => function ($name) { 

return $name; 

31); 

$router->model('bar', 'IlluminateNTestsNRoutingNRouteModelBi 
ndingStub'); 

$this->assertEquals('TAYLOR', $router->dispatch(Request::cre 
ate('foo/taylor', 'GET'))->getContent()); 


} 
class RouteModelBindingStub 
{ 
public function getRouteKeyName( ) 
{ 
return 'id'; 
} 
public function where($key, $value) 
{ 
$this->value = $value; 
return $this; 
} 
publie function Tanst() 
{ 
return strtoupper($this-»value); 
} 
} 


e 若 绑 定 的 model 并 没有 找到 对 应 路 由 参数 的 记录 ， 可 以 在 model 中 定义 
一 个 闭 包 函数 ， 路 由 参数 会 调用 闭 包 函数 : 


public function testModelBindingWithCustomNullReturn() 


{ 
$router = $this->getRouter(); 
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$router->get('foo/{bar}', ['middleware' => SubstituteBinding 
s::class, 'uses' => function ($name) { 
return $name; 
31); 
$router->model('bar', 'IlluminateNTestsNRoutingNRouteModelBi 
ndingNullstub’, function () 4 
return 'missing'; 
3); 
$this->assertEquals('missing', $router->dispatch(Request: :cr 
eate('foo/taylor', 'GET'))->getContent()); 
} 


public function testModelBindingWithBindingClosure() 
1 
$router = $this->getRouter(); 
$router->get('foo/{bar}', ['middleware' => SubstituteBinding 
s::class, 'uses' => function ($name) { 
return $name; 
31); 
$router->model('bar', 'IlluminateNTestsNRoutingNRouteModelBi 
ndingNullStub', function ($value) ( 
return (new RouteModelBindingClosureStub())-»findAlterna 
te($value); 
3); 
$this->assertEquals('tayloralt', $router-»dispatch(Request:: 
create('foo/TAYLOR', 'GET'))-»getContent()); 


j 
class RouteModelBindingNullStub 
{ 
public function getRouteKeyName( ) 
{ 
return 'id'; 
} 


public function where($key, $value) 


{ 


return $this; 


public function first() 


{ 
} 
} 
class RouteModelBindingClosureStub 
{ 
public function findAlternate($value) 
{ 
return strtolower($value).'alt'; 
} 
} 
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router 支 持 添 加 自 定 义 的 方法 ， 只 需要 利用 macro BRAEMAR EL 8 BRS Te d 
数 实 现 : 


public function testMacro() 
1 
$router = $this-»getRouter(); 
$router->macro('webhook', function () use ($router) { 
$router->match(['GET', 'POST'], 'webhook', function () { 
return 'OK'; 
3); 
3); 
$router-»webhook(); 
$this->assertEquals('OK', $router->dispatch(Request: :create( 
'webhook', 'GET'))-»getContent()); 
$this->assertEquals('OK', $router->dispatch(Request: :create( 
'webhook', 'POST'))->getContent()); 


} 


作为 laravel 极其 重要 的 一 部 分 ， route 功能 贯穿 着 整个 网 络 请 求 ， 是 
request 生命 周期 的 主干 。 本 文 主要 讲述 route 服务 的 注册 与 启动 、 路 由 的 属 
性 注册 。 本 篇 内 容 相 对 简单 ， 更 多 的 是 框架 添加 路 由 的 整体 设计 流程 。 


route 服务 的 注册 


laravel 在 接受 到 请 求 后 ， 先 进行 了 服务 容器 与 http 核心 的 初始 化 ， 再 进行 
了 请 求 request 的 构造 与 分 发 。 


az 


route 服务 的 注册 一 一 RoutingServiceProvider 发 生 在 服务 容器 
container 的 初始 化 上 ; 


route 服务 的 启动 与 加 载 一 一 RouteServiceProvider 发 生 在 request 的 
分 发 上 。 


route 服务 的 注册 一 一 RoutingServiceProvider 
所 有 需要 laravel 服务 的 请 求 都 会 加 载 入 口 文件 index.php : 


require _DIR_.'/../bootstrap/autoload.php'; 


$app = require_once DIR_.'/../bootstrap/app.php'; 





第 一 句 我 们 在 之 前 的 博客 提 过 ， 是 实现 PsRo ^ PSR4 标准 自动 加 载 的 功能 模 
块 ， 第 二 多 就 是 今天 说 的 container 的 初始 化 : 


$app = new Illuminate\Foundation\Application( 
realpath(__DIR_.'/../') 
); 


Application 


namespace IlluminateNFoundation; 


class Application extends Container implements ApplicationContra 
ct, HttpKernellnterface 


{ 
public function __construct($basePath = null) 
{ 
if ($basePath) { 
$this->setBasePath($basePath) ; 
} 
$this->registerBaseBindings(); 
$this->registerBaseServiceProviders(); 
$this-»registerCoreContainerAliases(); 
} 
} 


路 由 服务 的 注册 就 在 registerBaseServiceProviders() 这 个 函数 中 : 
protected function registerBaseServiceProviders() 
{ 
$this->register(new EventServiceProvider($this) ); 


$this->register(new LogServiceProvider($this) ); 


$this->register(new RoutingServiceProvider($this) ); 


RoutingServiceProvider 





namespace Illuminate\Routing; 


class RoutingServiceProvider extends ServiceProvider 


í 


public function register() 


{ 
$this->registerRouter(); 
} 
protected function registerRouter() 
{ 
$this->app->singleton('router', function ($app) { 
return new Router($app['events'], $app); 
}); 
} 


可 以 看 到 ， RoutingServiceProvider 做 的 事情 比较 简单 ， 就 是 向 服务 容易 中 注 
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route 服务 的 启动 与 加 载 
RouteServiceProvider 


laravel 在 初始 化 Application 后 ， 就 要 进行 http/Kernel 的 构造 : 
$kernel = $app->make(Illuminate\Contracts\Http\Kernel::class); 
$response = $kernel->handle( 


$request = Illuminate\Http\Request: :capture() 
); 


初始 化 结束 后 ， 就 会 调用 handle BH? Re BHRAT laravel 各 个 功能 服务 
的 注册 启动 ， 还 有 request NPR: 


public function handle($request) 


{ 
Ly si 
$request ->enableHttpMethodParameterOverride(); 
$response = $this->sendRequestThroughRouter ($request ); 
} 
return $response; 
} 


protected function sendRequestThroughRouter ($request ) 


{ 


$this->app->instance('request', $request); 
Facade: :clearResolvedInstance('request'); 
$this->bootstrap();// 各 种 服务 的 注册 与 启动 


return (new Pipeline($this->app))// 请 求 的 分 发 
->send($request ) 
->through($this->app->shouldSkipMiddleware() ? [ 
] : $this->middleware) 
->then($this->dispatchToRouter()); 


路 由 服务 的 启动 与 加 载 就 在 其 中 一 个 函数 中 bootstrap ， 这 个 函数 用 于 各 种 服务 
的 注册 与 启动 ， 比 较 复 杂 ， 我 们 有 机 会 在 以 后 单独 来 说 。 


总 之 ， 这 个 函数 会 调用 RouteServiceProvider 这 个 类 的 两 个 函数 : 注册 


register 、 启 动 boot ° 








由 于 route 的 注册 工作 由 之 前 RoutingServiceProvider 完成 ， 所 以 
RouteServiceProvider 的 register 是 空 的 ， 这 里 它 只 负责 路 由 的 启动 与 加 
载 工 作 ， 我 们 主要 看 boot 


namespace IlluminateNFoundationNSupportNProviders; 


class RouteServiceProvider extends ServiceProvider 


í 


public function register() 


{ 
(ey 
} 
public function boot() 
{ 
$this-»5setRootControllerNamespace(); 
if ($this->app->routesAreCached()) ( 
$this->loadCachedRoutes(); 
) else { 
$this->loadRoutes(); 
$this->app->booted(function () { 
$this->app['router']->getRoutes()->refreshNameLo 
okups(); 
$this-»app['router']-»getRoutes()-»refreshAction 
Lookups( ); 
3); 
} 
} 
protected function loadCachedRoutes() 
{ 
$this->app->booted(function () { 
require $this->app->getCachedRoutesPatn(); 
3); 
J 


protected function loadRoutes() 
{ 
if (method_exists($this, 'map')) { 
$this->app->call([$this, 'map']); 


class Application extends Container implements ApplicationContra 
ct, HttpKernelInterface 


{ 
public function routesAreCached( ) 
{ 
return $this['files']->exists($this->getCachedRoutesPath 
()); 
} 
public function getCachedRoutesPath() 
{ 
return $this->bootstrapPath().'/cache/routes.php'; 
} 
} 


从 boot 中 可 以 看 出 ， laravel 首先 去 寻找 路 由 的 缓存 文件 ， 没 有 缓存 文件 再 
去 进行 加 载 路 由 。 缓 存 文件 一 般 在 bootstrap/cache/routes.php 文件 中 。 


加 载 路 由 主要 调用 map 函数 ， 这 个 函数 一 般 在 
App\Providers\RouteServiceProvider 这 个 类 中 ， 这 个 类 继承 上 面 的 


Illuminate\Foundation\Support\Providers\RouteServiceProvider : 


use Illuminate\Foundation\Support\Providers\RouteServiceProvider 


as ServiceProvider; 


class RouteServiceProvider extends ServiceProvider 


{ 
public function map() 
{ 

$this->mapApiRoutes(); 

$this->mapWebRoutes(); 

Wh 

} 
protected function mapWebRoutes() 
{ 

Route: :middleware('web') 
->namespace($this->namespace ) 
->group(base_path('routes/web.php')); 

} 
protected function mapApiRoutes() 
{ 

Route: :prefix('api') 
-»middleware('api') 
->namespace($this->namespace ) 
->group(base_path('routes/api.php')); 

} 
} 


BE m 到 


laravle 将 路 由 分 为 两 个 大 组 : api ^ web 。 这 两 个 部 分 的 路 由 分 别 写 在 两 
个 文件 中 : routes/web.php ^ routes/api.php ° 


路 由 的 加 载 


所 谓 的 路 由 加 载 ， 就 是 将 定义 路 由 时 添加 的 属性 ， 例 如 
'name' ` 'domain' ` 'scheme' 等 等 保存 起 来 ， 以 待 后 用 。 


e laravel 定义 路 由 的 属性 的 方法 很 灵活 ， 可 以 定义 在 路 由 群 组 前 ， 例 如 : 


Route: :domain('route.domain.name' ) 
->group(function() { 
Route: :get('foo', 'controller@method'); 


t) 


e 可 以 定义 在 路 由 群 组 中 ， 例 如 : 


Route::group('domain' => 'group.domain.name',function() { 
Route: :get('foo', 'controller@method'); 


}) 


e 可 以 定义 在 method 的 前 面 ， 例如: 


Route: :domain('route.domain.name' ) 
->get('foo', 'controller@method' ); 


e 可 以 定义 在 method 中 ， 例 如 : 


Route::get('foo',['domain' => 'route.domain.name', 'use' => 'cont 
rollerQmethod']); 


e 还 可 以 定义 在 method Æ > Plte : 


Route: :get('{one}', 'use' => 'controller@method' ) 
->where('one', '(.+)'); 


事实 上 ， 路 由 的 加 载 功 能 主要 有 三 个 类 负责 : 
IlluminateNRoutingNRouter ^ IlluminateNRoutingNRoute ^ Illuminate 


NRoutingNRouteRegistrar ° 


Router 在 整个 路 由 功能 中 都 是 起 着 中 枢 的 作用 ， RouteRegistrar 主要 负责 
位 于 group ^ method 这 些 函 数 之 前 的 属性 注册 ， 例 如 上 面 的 第 一 种 和 第 三 
种 ， route 主要 负责 位 于 group ^ method 这 些 函 数 之 后 的 属性 注册 ， 例 如 
第 五 种 。 


RouteRegistrar 路 由 加 载 


属性 注册 


当 我 们 想 要 在 Route 后 面 直接 利用 domain() ^ name() 等 函数 来 为 路 由 注 
册 属 性 的 时 候 ， 我 们 实际 调用 的 是 router 的 魔术 方法 call(): 


namespace Illuminate\Routing; 


class Router implements RegistrarContract, BindingRegistrar 


{ 


public function __call($method, $parameters) 


{ 
if (static::hasMacro($method)) { 


return $this->macroCall($method, $parameters); 


return (new RouteRegistrar($this) )->attribute($method, $ 
parameters[0]); 


} 


在 类 RouteRegistrar 中 : 


class RouteRegistrar 


{ 
protected $allowedAttributes = [ 


'as', 'domain', 'middleware', 'name', 'namespace', ‘pref 


public function attribute($key, $value) 


{ 
if (! in_array($key, $this->allowedAttributes)) { 
throw new InvalidArgumentException("Attribute [{$key 
)] does not exist."); 


} 


$this->attributes[array_get($this->aliases, $key, $key) ] 
= $value; 


return $this; 


添加 路 由 


注册 属性 之 后 ， 创 建 路 由 的 时 候 ， 可 以 仅仅 提供 uri ， 可 以 提供 uri 5 Hl 
包 ， 可 以 提供 uri 5 控制 器 ， 可 以 提供 uri SRA: 


Route::as('Foo') 
-»namespace( 'Namespace\\Example\\' ) 
->get('foo/bar');//42% uri 


Route::as('Foo') 
-»namespace( 'Namespace\\Example\\' ) 
->get('foo/bar', function () { 
+); //uri 506 


Route::as('Foo') 
-»namespace( 'Namespace\\Example\\' ) 
->get('foo/bar', 'controllerQmethod');//uri 与 控制 器 


Route::as('Foo') 

-»namespace( 'Namespace\\Example\\' ) 

-»get('foo/bar', ['as'=> 'foo','use' =>'controller@method' ] 
);//uri 与 数组 


利用 get ^ post 等 方法 创建 新 的 路 由 时 ， 会 调用 类 RouteRegistrar 中 的 
魔术 方法 __call() 


class RouteRegistrar 


{ 
protected $passthru = [ 


geti post. “put >. "patens “delete: Voptions amy 
l; 


public function _ call($method, $parameters) 


it 
if (in array($method, $this->passthru)) { 
return $this->registerRoute($method, ...$parameters) 


if (in_array($method, $this->allowedAttributes)) ( 
return $this->attribute($method, $parameters[0]); 


throw new BadMethodCallException("Method [{$method}] doe 
S hot exist.) 


} 


protected function registerRoute($method, $uri, $action = nu 
TD) 


if (! is array($action)) { 
$action = array merge($this-»attributes, $action ? [ 
'uses' => $action] : []); 


} 


return $this->router->{$method}($uri, $this->compileActi 
on($action) ); 


} 


protected function compileAction( $action) 


{ 
if (is_null($action)) { 
return $this->attributes; 
} 
if (is_string($action) || $action instanceof Closure) { 
$action = ['uses' => $action]; 
} 
return array_merge($this->attributes, $action); 
} 


E TE nj 


也 就 是 说 ， RouteRegistrar 在 这 里 会 为 闭 包 或 控制 器 等 所 有 非 数组 的 action 
添加 use 键 ， 然 后 才 会 去 router 中 创建 路 由 。 


添加 路 由 群 组 


注册 属性 之 后 ， 还 可 以 创建 路 由 群 组 ， 但 是 这 时 路 由 群 组 不 允许 添加 属性 


action 


class RouteRegistrar 


{ 
public function group($callback) 
{ 
$this->router->group($this->attributes, $callback); 
} 
} 


Router 路 由 群 组 加 载 


路 由 群 组 的 功能 可 以 不 断 司 加 递归 ， 因 此 每 次 调用 group ， 都 要 用 新 路 由 群 组 的 
属性 与 昌 路 由 群 组 属性 合并 ， 以 待 新 的 路 由 去 继承 。 group AAT AA A E h 
数 ， 也 可 以 是 包含 定义 路 由 的 文件 路 径 。 


public function group(array $attributes, $routes) 


1 
$this->updateGroupStack($attributes) ; 


$this->loadRoutes($routes); 


array pop($this-»groupStack); 


protected function updateGroupStack(array $attributes) 


{ 
if (! empty($this->groupStack)) { 
$attributes = RouteGroup::merge($attributes, end($this-> 


groupStack) ); 
} 
$this->groupStack[] = $attributes; 
} 
protected function loadRoutes($routes) 
i 
if ($routes instanceof Closure) { 
$routes($this); 
} else { 
$router = $this; 
require $routes; 
J 
} 
关于 路 由 群 组 属性 的 合并 ， 


e prefix ^ as ^ namespace 这 几 个 属性 会 连接 在 一 起 ， 例 如 
prefixi/prefix2/prefix3 ° 

e where 属性 数组 相同 的 会 被 替换 ， 不 同 的 会 被 合并 。 

e domain 属性 会 被 替换 。 

e 其 他 属性 ， 例 如 middleware 数组 会 直接 被 合并 ， 即 使 存在 相同 的 元 素 。 


class RouteGroup 


{ 
public static function merge($new, $old) 
{ 
if (isset($new['domain'])) { 
unset($old['domain']); 
} 
$new = array_merge(static::formatAs($new, $old), [ 
'namespace' => static::formatNamespace($new, $01d), 
'prefix' => static::formatPrefix($new, $old), 
'where' => static::formatWhere($new, $old), 
1); 
return array merge recursive(Arr::except( 
$old, ['namespace', 'prefix', 'where', 'as'] 
), $new); 
} 
} 


Router 路 由 加 载 


添加 路 由 需要 很 多 步骤 ， 需 要 将 路 由 本 身 的 属性 和 路 由 群 组 的 属性 相 结合 。 


public function get($uri, $action = null) 


{ 
return $this->addRoute(['GET', 'HEAD'], $uri, $action); 


protected function addRoute($methods, $uri, $action) 


{ 


return $this->routes->add($this->createRoute($methods, $uri, 
$action) ); 


j 


protected function createRoute($methods, $uri, $action) 


1 


if ($this->actionReferencesController($action)) { 
$action = $this->convertToControllerAction($action) ; 


$route = $this->newRoute( 
$methods, $this->prefix($uri), $action 


); 


if ($this->hasGroupStack()) { 
$this->mergeGroupAttributesIntoRoute($route); 


$this->addwhereClausesToRoute($route) ; 


return $route; 


e 给 路 由 的 控制 器 添加 group 的 namespace 

e 给 路 由 的 uri 添加 group 的 prefix 前 组 
e 创建 新 的 路 由 

e 更 新 路 由 的 属性 信息 

e 为 路 由 添加 router - pattern LEMAR 

e 路 由 添加 到 RouteCollection 中 


控制 器 namespace 


路 由 控制 器 的 命名 空间 一 般 不 用 特别 指定 ， 默 认 值 是 
\App\Http\Controllers ， 每 次 创建 新 的 路 由 ， 都 要 将 默认 的 命名 空间 添加 到 控 
制 器 中 去 : 


protected function actionReferencesController ($action) 


{ 


if (! $action instanceof Closure) { 


return is_string($action) || (isset($action['uses']) && 


is string($action['uses'])); 


j 


return false; 


protected function convertToControllerAction($action) 


{ 
if (is_string($action)) { 
$action = ['uses' => $action]; 


if (! empty($this->groupStack)) { 


$action['uses'] = $this->prependGroupNamespace($action|[ ' 


uses']); 


} 


$action['controller'] = $action['uses']; 
return $action; 
protected function prependGroupNamespace($class) 
{ 
$group = end($this->groupStack ) ， 


return isset($group['namespace']) && strpos($class, 


? $group['namespace'].'\\'.$class : $class; 


uri 前 级 


在 创建 新 的 路 由 前 ， 需 要 将 路 由 群 组 的 prefix 添加 到 路 由 的 uri 


EN 


protected function prefix($uri) 
{ 

return trim(trim($this->getLastGroupPrefix(), '/').'/'.trim( 
SF 


} 
public function getLastGroupPrefix() 
{ 
if (! empty($this->groupStack)) { 
$last = end($this->groupStack); 
return isset($last['prefix']) ? $last['prefix'] : ''; 
} 
peruin e 
} 


创建 新 的 路 由 
路 由 的 创建 需要 Route X: 


protected function newRoute($methods, $uri, $action) 


{ 
return (new Route($methods, $uri, $action) ) 
->setRouter($this) 
->setContainer($this->container ); 


关于 Router 类 添加 新 的 路 由 我 们 在 下 一 部 分 详细 说 。 


更 新 路 由 属性 信息 


创建 新 的 路 由 之 后 ， 需 要 将 路 由 本 身 的 属性 action 与 路 由 群 组 的 属性 结合 在 一 
起 : 


public function hasGroupStack( ) 


{ 
return ! empty($this-»groupStack); 


protected function mergeGroupAttributesIntoRoute($route) 


{ 


$route->setAction($this->mergewithLastGroup($route->getActio 


n())); 
} 


添加 全 局 正则 约束 到 路 由 


上 一 篇 文章 我 们 说 过 ， 我 们 可 以 为 路 由 通过 pattern 方法 添加 全 局 的 参数 正则 约 
束 ， 所 有 每 次 添加 新 的 路 由 都 要 将 这 个 全 局 正则 约束 添加 到 路 由 中 : 


public function pattern($key, $pattern) 


{ 
$this->patterns[$key] = $pattern; 


protected function addWhereClausesToRoute($route) 


{ 
$route->where(array_merge( 
$this->patterns, isset($route->getAction()['where']) ? $ 
route->getAction()['where'] : [] 


)); 


return $route; 


Route 路 由 加 载 


前 面 说 过 ， 路 由 的 创建 是 由 Route 这 个 类 完成 的 : 


public function __construct($methods, $uri, $action) 


{ 
$this->uri = $uri; 
$this->methods = (array) $methods; 
$this->action = $this->parseAction($action); 


if (in_array('GET', $this->methods) && ! in array('HEAD', $t 
his->methods)) { 
$this->methods[] = 'HEAD'; 


if (isset($this->action['prefix'])) ( 
$this->prefix($this->action['prefix']); 


由 此 可 以 看 出 ， 路 由 的 创建 主要 是 路 由 的 各 个 属性 的 初始 化 ， 其 中 值得 注意 的 有 两 


个 : action 与 prefix 


action 解析 


protected function parseAction($action) 


{ 


return RouteAction::parse($this->uri, $action); 


我 们 可 以 看 出 ， 添 加 新 的 路 由 时 ， action 属性 需要 利用 RouteAction EX: 


class RouteAction 


{ 


public static function parse($uri, $action) 


{ 
if (is_null($action)) { 
return static: :missingAction($uri); 


if (is_callable($action)) { 


return ['uses' => $action]; 


elseif (! isset(Saction['uses'])) { 
$action['uses'] = static::findCallable($action); 


if (is_string($action['uses']) && ! Str::contains($actio 
n['uses'], '@')) { 


$action['uses'] = static: :makeInvokable($action[ 'use 


s']); 

} 
return $action; 

} 

protected static function findCallable(array $action) 

{ 
return Arr::first($action, function ($value, $key) { 

return is callable($value) && is numeric($key); 

3); 

j 


protected static function makeInvokable($action) 


t 
if (! method exists($action, ' invoke')) { 
throw new UnexpectedValueException("Invalid route ac 
tion: [{$action}]."); 
} 


return $action.'Q  invoke'; 


前 面 的 博客 我 们 说 过 ， 创 建 路 由 的 时 候 ， 除 了 为 路 由 分 配 控制 器 之 外 ， 还 可 以 为 路 
由 分 配 闭 包 元 数 ， 还 有 类 兄 数 ， 例 如 之 前 说 的 单 动 作 控 制 器 : 


$router->get('foo/bar2', [‘domain’ => 'www.example.com', 'Illumi 
nate\Tests\Routing\ActionStub']); 


class ActionStub 


{ 
public function __invoke() 
{ 
return 'hello'; 
} 
} 


因此 ， 解 析 action 主要 做 两 件 事 : 


e 为 闭 包 函数 添加 use 键 。 对 于 此 时 没有 use 键 的 路 由 ， 由 于 之 前 在 
Router 中 已 经 为 控制 器 添加 use 键 ， 因 此 这 时 没有 use 键 的 ， 必 然 是 
闭 包 函数 ， 在 这 里 直接 或 者 在 action 中 寻找 闭 包 函数 后 ， 为 闭 包 有 函数 添加 
use 键 。 


e 单 动作 控制 器 添加 ”invoke 。 对 于 单 动作 控制 器 来 党， 此 时 已 经 和 控制 器 
一 样 拥有 'use' 键 ， 但 是 并 没有 @ 符号 ， 此 时 就 会 调用 makeInvokable $% 
数 来 将 _ invoke 添加 到 后 面 。 

prefix 前 级 


路 由 自身 也 有 prefix 属性 ， 而 且 这 个 属性 要 加 在 其 他 prefix 的 最 前 面 ,作为 
路 由 的 uri 


public function prefix($prefix) 
{ 
$uri = rtrim($prefix, '/').'/'.ltrim($this-»uri, '/'); 


$this->uri = trim($uri, '/'); 


return $this; 


Route 路 由 属性 加 载 


除了 RouteRegistrar 之 外 ， Route 也 可 以 为 路 由 添加 属性 : 
prefix Ay 2 


public function prefix($prefix) 


{ 
$uri = rtrim($prefix, '/').'/'.ltrim($this-»uri, '/'); 
$this->uri = trim($uri, '/'); 
return $this; 

} 


where 正则 约束 


public function where($name, $expression = null) 


{ 


foreach ($this->parsewhere($name, $expression) as $name => $ 
expression) { 
$this->wheres[$name] = $expression; 


return $this; 


protected function parseWhere($name, $expression) 


{ 


return is_array($name) ? $name : [$name => $expression]; 


middleware 中 间 件 


public function middleware($middleware = null) 
{ 
if (is_null($middleware)) { 
return (array) Arr::get($this->action, 'middleware', []) 


if (is_string($middleware)) { 
$middleware = func_get_args(); 


$this->action[ 'middleware'] = array merge( 
(array) Arr::get($this->action, 'middleware', []), $midd 
leware 


); 


return $this; 


ga, 


uses 控制 3 


public function uses($action) 
{ 

$action = is_string($action) ? $this->addGroupNamespaceToStr 
ingUses($action) : $action; 


return $this->setAction(array_merge($this->action, $this->pa 
rseAction([ 
'uses' => $action, 
'controller' => $action, 


]))); 


name 命名 


public function name($name) 


{ 
$this->action['as'] = isset($this->action['as']) ? $this->ac 
tion['as'].$name : $name; 


return $this; 


RouteCollection 添加 路 由 
在 上 面 的 部 分 ， 我 们 看 到 添加 路 由 的 代码 : 


protected function addRoute($methods, $uri, $action) 


i 


return $this->routes->add($this->createRoute($methods, $uri, 
$action) ); 


} 


新 创建 的 路 由 会 加 入 到 RouteCollection 中 ， 会 更 新 类 中 的 


routes ^ allRoutes ^ nameList ^ actionList ° 


public function add(Route $route) 


1 
$this->addToCollections($route); 
$this->addLookups($route); 
return $route; 
} 
protected function addToCollections($route) 
{ 
$domainAndUri = $route->domain().$route->uri(); 
foreach ($route->methods() as $method) { 
$this->routes[$method][$domainAndUri] = $route; 
} 
$this->allRoutes[$method.$domainAndUri] = $route; 
} 
protected function addLookups($route) 
{ 
$action = $route-»getAction(); 
if (isset($action['as'])) { 
$this->nameList[$action['as']] = $route; 
} 
if (isset($action['controller'])) { 
$this->addToActionList($action, $route); 
J 
} 


protected function addToActionList($action, $route) 


{ 


$this->actionList[trim($action['controller'], '\\')] = $rout 


我 们 在 上 面 路 由 的 注册 启动 章节 说 道 ， 路 由 的 启动 是 namespace 
Illuminate\Foundation\Support\Providers\RouteServiceProvider 完成 
的 ， 调 用 的 是 boot WA: 


public function boot() 


{ 
$this->setRootControllerNamespace(); 
if ($this->app->routesAreCached()) { 
$this->loadCachedRoutes(); 
} else { 
$this->loadRoutes(); 
$this->app->booted(function () { 
$this-»app['router']-»getRoutes()-»refreshNameLookup 
s(); 
3): 
} 
} 


在 最 后 一 多 ， 程 序 将 会 在 所 有 服务 都 启动 后 运行 refreshNameLookups 函数 ， 把 
所 有 的 name 属性 加 载 到 RouteCollection 中 : 


public function refreshNameLookups() 


1 
$this->nameList = []; 
foreach ($this->allRoutes as $route) { 
if ($route->getName()) { 
$this->nameList[$route->getName()] = $route; 
} 
} 
} 


测试 样 例如 下 : 


public function testRouteCollectionCanRef reshNameLookups( ) 


( 


$routelndex - new Route('GET', 'foo/index', [ 
'uses' => 'FooControllerQindex', 


]); 


$this->assertNull($routeIndex->getName()); 


$this->routeCollection->add($routeIndex)->name('route name') 


$this->assertNull($this->routeCollection->getByName('route_n 
ame')); 


$this->routeCollection->refreshNameLookups(); 
$this->assertEquals($routeIndex, $this->routeCollection->get 
ByName('route_name')); 


} 


当 所 有 的 路 由 都 加 载 完 毕 后 ， 就 会 根据 请 求 的 url 来 将 请 求 分 发 到 对 应 的 路 由 上 
去 。 然 而 ， 在 分 发 到 路 由 之 前 还 要 经 过 各 种 中 间 件 的 计算 。 laravel 利用 装饰 者 
模式 来 实现 中 间 件 的 功能 。 


从 原始 装饰 者 模式 到 闭 包装 饰 者 
装饰 者 模式 是 设计 模式 的 一 种 ， 主 要 进行 对 象 的 多 次 处 理 与 过 滤 ， 是 在 开放 -关闭 原 
则 下 实现 动态 添加 或 减少 功能 的 一 种 方式 。 下 面 先 看 一 个 装饰 者 模式 的 例子 : 


总 共有 两 种 咖啡 : Decaf、Espresso， 另 有 两 种 调味 品 : Mocha、Whip (3 种 设计 
的 主要 差别 在 于 抽象 方式 不 同 ) 


装饰 模式 分 为 3 个 部 分 : 
1， 抽 象 组 件 -- 对 应 Coffee 类 
2， 具 体 组 件 -- 对 应 具体 的 咖啡 ， 如 : Decaf > Espresso 


3> 装饰 者 m 对 应 调味 品 » 4a : Mocha， Whip 


原始 装饰 者 模式 


public interface Coffee 


{ 

public double cost(); 
} 
public class Espresso implements Coffee 
{ 

public double cost() 

{ 

reich 2 5 
} 


public class Dressing implements Coffee 


£ 


private Coffee coffee; 


public Dressing(Coffee coffee) 


í 


this.coffee = coffee; 


} 
public double cost() 
{ 
return coffee.cost(); 
} 


public class Whip extends Dressing { 
public Whip(Coffee coffee) 


t 
super(coffee); 
} 
public double cost() 
{ 
return super.cost() + 0.1; 
} 


public class Mocha extends Dressing 


{ 
public Mocha(Coffee coffee) 


{ 


super (coffee); 


} 
public double cost() 
{ 
return super.cost() + 0.5; 
} 


当 我 们 使 用 装饰 者 模式 的 时 候 : 


public class Test { 
public static void main(String[] args) { 

Coffee coffee = new Espresso(); 
coffee = new Mocha(coffee); 
coffee = new Mocha(coffee); 
coffee = new Whip(coffee); 
r/9o20(255 0:5 42055 50:1) 
a ee 


我 们 可 以 看 出 来 ， 装 饰 者 模式 就 是 利用 装饰 者 类 来 对 具体 类 不 断 的 进行 多 层次 的 处 
理 ， 首 先 我 们 创建 了 acl 类 ， 然 后 第 一 次 利用 Mocha 装饰 者 对 
Espresso 咖啡 加 了 摩卡 ， 第 二 次 重复 加 了 摩卡 ， 第 三 次 利用 装饰 者 Whip 对 
Espresso 咖啡 加 了 奶油 。 a ， 装 饰 者 都 会 对 价格 cost 做 一 些 
处 理 (+0.1 ` 40.5) ° 


无 构造 函数 的 装饰 者 


我 们 对 这 个 装饰 者 进 


public class Espresso 


{ 
double cost; 
public double cost() 
{ 
$this-> cost = 2.5; 
} 
} 
public class Dressing 
{ 
public double cost(Espresso $espresso) 
{ 
return ($espresso); 
} 
} 
public class Whip extends Dressing 
{ 
public double cost(Espresso $espresso) 
{ 
$espresso->cost = espresso->cost() + 0.1; 
return ($espresso); 
} 
} 


public class Mocha extends Dressing 


{ 


public double cost(Espresso $espresso) 


í 


$espresso->cost = espresso->cost() + 0.5; 


return ($espresso); 


public class Test { 


public static void main(String[] args) { 
Coffee $coffee = new Espresso(); 


$coffee 
$coffee 
$coffee 


//3.6(2. 


E 


(new Mocha( ))-»cost(S$coffee); 
(new Mocha())->cost($coffee); 
(new Whip())-»cost(S$coffee); 


a (9. oP (5 e eal) 


System.out.println(coffee.cost()); 


改造 后 ， 装 饰 者 类 通过 有 函数 cost 来 注入 具体 类 caffee c S078 EGÉGIJ ih h 
数 ， 这 样 做 有 助 于 自动 化 进行 装饰 处 理 。 我 们 改造 后 发 现 ， 想 要 对 具体 类 通过 装饰 
类 进行 处 理 ， 需 要 不 断 的 调用 cost 元 数 ， 如 果 有 10 个 装饰 操作 ， 就 要 手动 写 10 
个 语句 ， 因 此 我 们 继续 进行 改造 : 


闭 包 装饰 者 模式 


public class Espresso 


{ 
double cost; 
public double cost() 
{ 
Sthis-> cost = 2,5; 
} 
} 
public class Dressing 
{ 
public double cost(Espresso $espresso, Closure $closure) 
{ 
return ($espresso); 
} 
} 
public class Whip extends Dressing 
{ 
public double cost(Espresso $espresso, Closure $closure) 
{ 
$espresso->cost = espresso->cost() + 0.1; 
return $closure($espresso); 
} 
} 


public class Mocha extends Dressing 


{ 


public double cost(Espresso $espresso, Closure $closure) 


í 


$espresso->cost = espresso->cost() + 0.5; 


return $closure($espresso); 


public class Test { 
public static void main(String[] args) { 
Coffee $coffee = new Espresso(); 


$fun = function($coffee’ $fuc’ $dressing) { 
$dressing->cost($coffee, $fuc); 


$fucO = function($coffee) { 
return $coffee; 


ty 


$fuci = function($coffee) use ($fucO, $dressing = (new M 


ocha() * $fun)) ( 
return $fun($coffee, $fuco, $dressing); 


$fuc2 = function($coffee) use ($fuci, $dressing = (new M 


ocha() s Strum))c 
return $fuc($coffee, $funi, $dressing); 


$fuc3 = function($coffee) use ($fuc2, $dressing = (new W 
hip()* $fun)) { 


return $fuc($coffee, $fun2, $dressing); 
$coffee = $fun3($coffee) ; 


Li S26 225) tog. s FO l5 ct 
System.out.println(coffee.cost()); 


在 这 次 改造 中 ， 我 们 使 用 了 闭 包 有 函数 ， 这 样 做 的 目的 在 于 ， 我 们 只 需要 最 后 一 多 
$fun3($coffee) ,就 可 以 启动 整个 装饰 链条 。 


闭 包 装饰 者 的 抽象 化 


然而 这 种 改造 还 不 够 深入 ， 因 为 我 们 还 可 以 把 $fuci ^ $fuc2 ^ $fuc3 继续 
抽象 化 为 一 个 闭 包 函数 ， 这 个 财 包 有 函数 仅仅 是 参数 $fuc ^ $dressing 每 次 不 
F > $coffee 相同 ， 因 此 改造 如 下 : 


public class Test { 
public static void main(String[] args) { 
Coffee $coffee = new Espresso(); 
$fun = function($coffee) use ($fuc’ $dressing) { 


$dressing->cost($coffee, $fuc); 


$fuc = function($fuc ’ $dressing) use ($fun) { 
return $fun; 


ia 


$fucO = function($coffee) { 
return $coffee; 


H 

$fuci = $fuc($fucO, (new Mocha()); 
$fuc2 = $fuc($fuci, (new Mocha()); 
$fuc3 = $fuc($fuc2, (new whip()); 
$coffee = $fun3($coffee) ; 


Pel Si eo Oe Eee Oe a OS a Gia) 
System.out.println(coffee.cost()); 


这 次 ， 我 们 把 之 前 的 闭 包 分 为 两 个 部 分 ， $fun 负责 具体 类 的 参数 传 
i$ ^ fuc 负责 装饰 者 和 闭 包 函数 的 参数 传递 。 在 最 后 一 名 $fun3 ,只 需要 传递 
一 个 具体 类 ， 就 可 以 启动 整个 装饰 链条 。 


闭 包 装饰 者 的 自动 化 


到 这 里 ， 我 们 还 有 一 件 事 没有 完成 ， 那 就 是 $fucl ^ $fuc2 ^ $fuc3 这 些 闭 
包 的 构建 还 是 手动 的 ， 我 们 需要 将 这 个 过 程 改 为 自动 的 : 


public class Test { 
public static void main(String[] args) { 
Coffee $coffee = new Espresso(); 


$fun = function($coffee) use ($fuc’ $dressing) { 
$dressing->cost($coffee, $fuc); 


$fuc = function($fuc > $dressing) use ($fun) ( 
return $fun; 


ia 


$fuco = function($coffee) { 
return $coffee; 


ia 


$fucn = array reduce( 
[(new Mocha( ), (new Mocha(),(new Whip()], $fuc, $fucO 
); 


$coffee = $fucn($coffee) ; 


A/o30(225 + Oso + 0,5 2 6.1) 
System.out.println(coffee.cost()); 


laravel 的 闭 包 装饰 者 一 一 Pipeline 


上 一 章 我 们 说 到 了 路 由 的 注册 局 动 与 加 载 过 程 ， 这 个 过 程 由 bootstrap() 
成 。 当 所 有 的 路 由 加 载 完 毕 后 ， 就 要 进行 各 种 中 间 件 的 处 理 了 : 


protected function sendRequestThroughRouter ($request ) 
{ 
$this->app->instance('request', $request); 
Facade: :clearResolvedInstance('request'); 


$this->bootstrap(); 


return (new Pipeline($this->app) ) 
->send($request ) 


->through($this->app->shouldSkipMiddleware() ? [ 


] : $this->middleware) 
->then($this->dispatchToRouter()); 


} 
public function shouldSkipMiddleware( ) 
{ 
return $this->bound('middleware.disable') && 
$this->make('middleware.disable') === true; 
} 


laravel 的 中 间 件 处 理由 pipeline 来 完成 ， 它 是 一 个 闭 包 装饰 者 模式 ， 其 中 


e request 是 有 具体 类 ， 相 当 于 我 们 上 面 的 caffee X; 
e middleware 中 间 件 是 装饰 者 类 ， 相 当 于 上 面 的 dressing 类 ; 


我 们 先 看 看 这 个 类 内 部 的 代码 : 


class Pipeline implements PipelineContract 


{ 


public function __construct(Container $container = null) 


{ 


$this->container = $container; 


public function send($passable) 


{ 
$this->passable = $passable; 
return $this; 
J 
public function through($pipes ) 
{ 
$this->pipes = is_array($pipes) ? $pipes : func get args 
0; 
return $this; 
J 


public function then(Closure $destination) 
{ 
$pipeline = array_reduce( 
array_reverse($this->pipes), $this->carry(), $this-> 
prepareDestination($destination) 


); 


return $pipeline($this->passable); 


protected function prepareDestination(Closure $destination) 
{ 
return function ($passable) use ($destination) { 
return $destination($passable); 


c 


protected function carry() 
{ 
return function ($stack, $pipe) { 
return function ($passable) use ($stack, $pipe) { 
if ($pipe instanceof Closure) { 
return $pipe($passable, $stack); 
} elseif (! is object($pipe)) { 


list($name, $parameters) = $this->parsePipeS 
tring($pipe); 


$pipe = $this-»getContainer()-»make($name); 
$parameters = array merge([$passable, $stack 
], $parameters); 


) else { 
$parameters = [$passable, $stack]; 


return $pipe->{$this->method}(...$parameters); 
J; 
J; 


pipeline 的 构造 和 我 们 上 面 所 讲 的 闭 包 装饰 者 相同 ， 我 们 着 重 来 看 carry() 
函数 的 代码 : 


function ($stack, $pipe) { 


最 外 层 的 闭 包 相当 于 上 个 章节 的 $fuc , 


function ($passable) use ($stack, $pipe) { 


里 面 的 这 一 层 比 闭 包 型 党 与 上 个 章节 的 $fun ， 


prepareDestination 这 个 函数 相当 于 上 面 的 $fuco , 


if ($pipe instanceof Closure) ( 
return $pipe($passable, $stack); 
} elseif (! is object($pipe)) { 
list($name, $parameters) = $this->parsePipeStrin 
g($pipe); 


$pipe = $this-»getContainer()-»make($name); 


$parameters = array merge([$passable, $stack], $ 
parameters); 
) else { 
$parameters = [$passable, $stack]; 


return $pipe->{$this->method}(...$parameters); 


这 一 部 分 相当 于 上 个 章节 的 Sdressing->cost($coffee, $fuc); ,这 部 分 主要 解 
析 中 间 件 handle() 函数 的 参数 : 


public function via($method) 


{ 
$this->method = $method; 


return $this; 


protected function parsePipeString($pipe) 


{ 


list($name, $parameters) = array pad(explode(':', $pipe, 2), 


2, []); 


if (is string($parameters)) { 
$parameters = explode(',', $parameters); 


return [$name, $parameters]; 








这 样 ， laravel 就 实现 了 中 间 件 对 request 的 层 层 处 理 。 


利用 pipeline 进行 中 间 件 的 层 层 处 理 后 ， 接 下 来 laravel 就 会 利用 请 求 的 
url 来 寻找 与 其 对 应 的 路 由 ， laravel 采用 对 路 由 注册 的 uri 进行 正则 编 
译 ， 然 后 利用 request 的 url 进行 正则 匹配 来 寻找 正确 的 路 由 。 


前 期 准备 


在 上 一 篇 文章 中 ， 我 们 了 解 了 Pipeline 的 原理 ， 我 们 知道 它 调用 了 
dispatchToRouter() 这 个 函数 : 


protected function sendRequestThroughRouter ($request ) 


£ 


$this->app->instance('request', $request); 
Facade: :clearResolvedInstance('request'); 
$this->bootstrap(); 


return (new Pipeline($this->app)) 
->send($request) 
->through($this->app->shouldSkipMiddleware() ? [ 
] : $this->middleware) 
->then($this->dispatchToRouter()); 


protected function dispatchToRouter() 


{ 


return function ($request) { 
$this->app->instance('request', $request); 


return $this->router->dispatch($request); 


HH 


这 个 函数 实际 上 利用 的 是 Router 的 dispatch ,这 个 函数 的 任务 是 进行 路 由 匹 
配 ， 并 且 调 用 路 由 绑 定 的 控制 器 或 者 闭 包 函数 : 


class Router implements RegistrarContract, BindingRegistrar 


i 


public function dispatch(Request $request ) 


{ 


$this->currentRequest = $request; 


return $this->dispatchToRoute($request); 


public function dispatchToRoute(Request $request ) 


{ 
$route = $this->findRoute($request); 


$request ->setRouteResolver(function () use ($route) { 
return $route; 


3); 


$this->events->dispatch(new EventsNRouteMatched($route, 
$request)); 


$response = $this->runRoutewithinStack($route, $request) 


return $this-»prepareResponse($request, $response); 


我 们 这 篇 文章 就 是 讲解 第 一 句 : findRoute() 路 由 匹配 : 


protected function findRoute($request ) 


1 
$this->current = $route = $this-»routes-»match($request); 
$this->container ->instance(Route::class, $route); 
return $route; 

} 


寻找 路 由 的 任务 由 RouteCollection 负责 ， 这 个 函数 负责 匹配 路 由 ， 并 且 把 
request 的 url 参数 绑 定 到 路 由 中 : 


class RouteCollection implements Countable, IteratorAggregate 


{ 


public function match(Request $request ) 


t 
$routes = $this-»get($request-»getMethod()); 


$route = $this->matchAgainstRoutes($routes, $request); 


if (! is_null($route)) { 
return $route->bind($request); 


$others = $this-»checkForAlternateVerbs($request); 


if (count($others) > 0) { 
return $this->getRouteForMethods($request, $others); 


throw new NotFoundHttpException; 


protected function matchAgainstRoutes(array $routes, $reques 
t, $includingMethod = true) 


{ 
return Arr::first($routes, function ($value) use ($reque 
st, $includingMethod) { 
return $value->matches($request, $includingMethod) ; 


3); 


路 由 正则 匹配 


如 何 去 寻找 请 求 request 想 要 调用 的 路 由 呢 ? laravel 首先 对 路 由 进行 正则 
编译 ， 得 到 路 由 的 正则 匹配 串 ， 然 后 利用 请 求 的 url 尝试 去 匹配 ， 如 果 匹 配 成 
功 ， 那 么 就 会 选 定 该 路 由 : 


class Route 
{ 
public function matches(Request $request, $includingMethod = 
true) 


{ 


$this->compileRoute(); 


foreach ($this->getValidators() as $validator) { 
if (! $includingMethod && $validator instanceof Meth 
odValidator) { 
continue; 


if (! $validator->matches($this, $request)) { 
return false; 


} 
} 
return trues; 
} 
protected function compileRoute() 
{ 
if (! $this->compiled) { 
$this->compiled = (new RouteCompiler($this))-»compil 
e(); 
} 
return $this->compiled; 
} 


可 以 看 出 ， 路 由 的 正则 编译 由 RouteCompiler 类 专门 负责 : 


class RouteCompiler 


{ 


public function — construct($route) 


( 


$this->route = $route; 


public function compile( ) 


{ 


$optionals = $this-»getOptionalParameters(); 


$uri = preg_replace('/\{(\w+?)\?\}/', '{$1}', $this->rou 
te->uri()); 


return ( 
new SymfonyRoute($uri, $optionals, $this->route->whe 
res, [], $this->route->domain() ?: '') 


)->compile(); 


可 以 看 出 ， laravel 费 正 的 正则 编译 是 重用 symfony 框架 的 ， 但 是 在 利用 
symfony 进行 正则 编译 之 前 ， laravel 先 对 路 由 的 uri 进行 了 一 些 处 理 ， 以 
适应 symfony 的 要 求 。 


路 由 可 选 参数 转换 


对 于 laravel 来 说 ， 可 以 选择 某 个 路 由 url 的 参数 是 可 选 的 ， 通 常 来 说 ， 这 
种 可 选 参 数 都 有 默认 值 。 laravel 利用 ? 来 表示 可 选 参数 : 


$router->get('{foo?}/{baz?}', function ($name = 'taylor', $age = 
25) 4 
return $name. $age; 


3): 
加 = ES] 





| a5 4 I mlazg 了 又 
Laravel HTTF Rr TE] SJ X JT] Zim VE 


但 是 对 于 symfony 来 说 ， ? 没有 任何 特殊 意义 ， symfony 利用 
SymfonyRoute 类 进行 路 由 初始 化 ， 并 把 第 二 个 参数 作为 可 选 参数 ， 因 此 
laravel 需要 把 可 选 参 数 提取 出 来 ， 然 后 赋 给 SymfonyRoute Wis HA o 


可 选 参数 的 提取 由 getOptionalParameters 负责 : 


protected function getOptionalParameters() 


{ 
preg_match_all('/\{(\wt+?)\?\}/', $this->route->uri(), $match 


es); 


return isset($matches[1]) ? array_fill_keys($matches[1], null 
) : []; 


0] 
preg match all 交 数 用 于 进行 正则 表达 式 全 局 匹配 ， 成 功 返 回 整 个 模式 匹 


配 的 次 数 (TARA A) ， 如 果 出 错 返 回 FALSE 。 


默认 排序 方式 为 ”PREG_PATTERN_ORDER ,结果 排序 为 $matches[0] 保存 完 
整 模式 的 所 有 匹配 ，$matches[1] 保存 第 一 个 子 组 的 所 有 匹配 ， 以 此 类 推 。 


若 排序 方式 为 ”PREG_SET_ORDER ,结果 排序 为 $matches[0] 包含 第 一 次 匹 
配 得 到 的 所 有 匹配 (包含 子 组 )，  $matches[1] 是 包含 第 二 次 匹配 到 的 所 有 匹 
配 (包含 子 组 ) 的 数组 ， 以 此 类 推 。 


以 {f00?}/{baz?} 为 例 ， 得 到 的 matches[0] : 


matches[0] = array ( 
0 = '{foo?}', 
j= *f{baz?} 


得 到 的 结果 matches 中 matches[1] 是 被 匹配 上 的 字符 串 ， 以 
{f00?}/{baz?} 为 例 ， 得 到 的 matches[1] : 


matches[1] = array ( 


gcc foo 
1 = 'baz', 


array fill keys Sac ih we FA 48 E 09 48 Fe 48 2E ALKA > Bil to Ll P SLT AFF 


到 : 


optionals = array ( 


得 到 可 选 参 数 的 数组 optionals 


foo = null, 
baz = null, 


后 ， 就 要 将 路 由 的 uri 中 


? 


替换 掉 ， 这 也 


就 是 preg_replace 的 作用 ， 以 {f00?}/{baz?} 为 例 ， 最 后 得 到 的 替换 结果 
为 {foo}/{baz} ° 


Symfony 路 由 初始 化 


在 symfony 的 路 由 初始 化 中 ， 由 很 多 参数 : 


path 是 路 由 的 uri 

defaults 是 路 由 可 选 参数 

requirements 是 路 由 的 参数 正则 约束 

options 路 由 的 选项 参数 ， 例 如 路 由 正则 编译 类 等 
host 是 路 由 的 主 域 

schenes 是 Web 的 协议 ， 例 如 http, https 
methods 是 调用 的 方法 ， 例 如 get ^ post 
condition 


namespace Symfony\Component\Routing; 


class Route implements \Serializable 
{ 
public function _construct($path, array $defaults = array() 
, array $requirements = array(), array $options = array(), $host 
= '', $schemes = array(), $methods = array(), $condition = '') 
t 
$this->setPath($path) ; 
$this-»setDefaults($defaults); 
$this->setRequirements($requirements) ; 
$this->setOptions($options); 
$this->setHost($host); 
$this->setSchemes($schemes); 
$this->setMethods($methods); 
$this->setCondition($condition); 


public function setOptions(array $options) 


t 
$this->options = array( 
'compiler class' => 'Symfony\\Component\\Routing\\Ro 
uteCompiler', 


): 


return $this-»-addOptions($options); 


可 以 看 出 ， laravel 和 初始 化 路 由 的 时 候 ， 分 别 初始 化 了 
path ^ defaults ^ requirements ^ host ， 其 余 都 是 默认 值 。 其 中 
host 是 路 由 的 domain ÆR http ^ https 之 后 的 主 域 。 


public function domain() 


{ 
return isset($this->action['domain' ]) 
7 str_replace(['http://', 'https://'], '', $this->ac 
tion['domain']) : null; 


j 


路 由 的 正则 编译 
路 由 的 编译 由 symfony 的 route 类 完成 : 


public function compile( ) 


{ 
if (null !== $this->compiled) { 
return $this->compiled; 
J 
$class = $this-»getOption('compiler class'); 
return $this->compiled = $class::compile($this); 
y 


compiler class 是 初始 化 的 时 候 提 供 的 类 
Symfony\\Component\\Routing\\RouteCompiler . 


下 面 是 就 是 路 由 编译 的 主要 功能 实现 : 
compile 函数 


namespace Symfony\Component\Routing; 


class RouteCompiler implements RouteCompilerInterface 


( 


public static function compile(Route $route) 


í 


$hostVariables = array(); 


$variables = array(); 
$hostRegex = null; 
$hostTokens = array(); 


if ('' !== $host = $route->getHost()) { 
$result = self::compilePattern($route, $host, true); 


$hostVariables = $result['variables']; 
$variables = $hostVariables; 


$hostTokens = $result['tokens']; 
$hostRegex = $result['regex']; 


$path = $route->getPath(); 


$result = self::compilePattern($route, $path, false); 


$staticPrefix = $result['staticPrefix']; 


$pathVariables = $result['variables']; 


foreach ($pathVariables as $pathParam) { 
if (' fragment' === $pathParam) { 
throw new NInvalidArgumentException(sprintf('Rou 
te pattern "%s" cannot contain " fragment" as a path parameter. ' 
, $route-»getPath( ))); 
} 


$variables = array_merge($variables, $pathVariables); 


$tokens = $result['tokens']; 
$regex = $result['regex']; 


return new CompiledRoute( 
$staticPrefix, 
$regex, 
$tokens, 
$pathVariables, 


$hostRegex, 

$hostTokens, 
$hostVariables, 
array_unique($variables) 


可 以 看 出 ， 路 由 的 正则 编译 由 两 个 部 分 构成 : 主 域 的 正则 编译 与 uri 的 正则 编 
译 。 这 两 个 部 分 的 编译 功能 由 函数 compilePattern 负责 ， 这 个 函数 会 有 返回 三 
种 数据 结果 ， 以 /foo/{bar} 为 例 : 


e variables 代表 正则 匹配 的 路 由 参数 ,如 bar 

e tokens 代表 正则 匹配 的 普通 路 由 字符 串 , 如 foo 

e regex 代表 路 由 匹配 的 正则 表达 式 结果 

e 有 时 候 也 会 有 S$staticPrefix ,这 个 是 路 由 url 前 没有 路 由 参数 的 字符 串 


前 级， 如 /foo/. 


compilePattern x 


由 于 symfony 原始 的 正则 编译 稍微 复杂 ， 本 文 别 除 了 一 些 处 理 utf8 和 异常 处 
理 的 代码 ， 特 意 挑选 计算 正则 表达 式 的 主干 代码 ， 如 下 : 


private static function compilePattern(Route $route, $patter 
n, $isHost) 
{ 
$tokens = array(); 
$variables = array(); 
$matches = array(); 
$pos = 0; 
$defaultSeparator = $isHost ? '.' : '/'; 


preg_match_all('#\{\w+\}#', $pattern, $matches, PREG OFF 
SET CAPTURE | PREG SET ORDER); 
foreach ($matches as $match) { 
$varName = substr($match[O][9], 1, -1); 
$precedingText = substr($pattern, $pos, $match[0][1] 
- $pos); 


$pos = $match[O][1] + strlen($match[9][9]); 


if (!strlen($precedingText)) { 


$precedingChar = ''; 
} else { 
$precedingChar = substr($precedingText, -1); 
} 
$isSeparator = '' !== $precedingChar && false !== st 


rpos(static::SEPARATORS, $precedingChar); 


if ($isSeparator && $precedingText !== $precedingCha 
r) { 
$tokens[] = array('text', substr($precedingText, 
0, -strlen($precedingChar))); 
} elseif (!$isSeparator && strlen($precedingText) > 0 


) { 
$tokens[] = array('text', $precedingText); 
} 
$regexp = $route->getRequirement($varName); 
if (null === $regexp) { 
$followingPattern = (string) substr($pattern, $p 
os); 


$nextSeparator = self::findNextSeparator($follow 
ingPattern, $useUtf8); 
$regexp = sprintf( 
"SH 
preg_quote($defaultSeparator, self::REGEX_DE 
LIMITER), 
$defaultSeparator !-- $nextSeparator && '' ! 
== $nextSeparator ? preg_quote($nextSeparator, self::REGEX DELIM 
THER) o> 


): 


if (('' !== $nextSeparator && !preg match( 'Z^N(^N 
w+\}#', $followingPattern)) || '' === $followingPattern) { 
$regexp .= '-*'; 
} 


$tokens[] = array('variable', $isSeparator ? $preced 
ingChar : '', $regexp, $varName); 
$variables[] - $varName; 


if ($pos « strlen($pattern)) { 
$tokens[] = array('text', substr($pattern, $pos)); 


// find the first optional token 

$firstOptional = PHP INT MAX; 

if (!$isHost) { 

for ($i = count($tokens) - 1; $i >= 0; --$i) { 
$token = $tokens[$i]; 
if ('variable' === $token[0] && $route->hasDefau 
lt($token[3])) { 
$firstOptional = $i; 


} else { 
break; 
} 
} 
} 
// compute the matching regexp 
$regexp = ''; 
for ($i = 0, $nbToken = count($tokens); $i < $nbToken; + 
+$1) { 
$regexp .= self::computeRegexp($tokens, $i, $firstOp 
tional); 
} 
$regexp = self::REGEX DELIMITER.'^'.$regexp.'$'.self::RE 
GEX_DELIMITER. 's'.($isHost ? 'i' : ''); 
return array( 
'staticPrefix' => 'text' === $tokens[0][0] ? $tokens[ 
oJ[1] : '', 


'regex' => $regexp, 
'tokens' => array_reverse($tokens), 
'variables' => $variables, 


); 
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下 面 本 文 将 以 prefix/{foo}/{baz}.{ext}/tail 为 例 ， 来 详细 讲 一 下 路 由 
uri 的 正则 编译 过 程 。 


preg match all 全 匹配 


由 于 preg match all 使 用 了 PREG SET ORDER ,因此 结果 数组 matches 中 
每 一 个 元 素 都 是 一 次 匹配 的 结果 ， 本 例 中 : 


$matches = array ( 


© = array ( 
© = array ( 
0 = "{foo}", 
15-59 
) 
) 
1 = array ( 
© = array ( 
0 = "{baz}", 
1= 14 
) 
) 
2 = array ( 
© = array ( 
© = "(ext)", 
1 = 20 
) 


接 下 来 ， 程 序 会 用 循环 来 分 别处 理 各 个 匹配 的 结果 。 


- 
AR EZ 


又 里 


每 个 匹配 结果 都 会 先 计算 变 量 : 


varName 、 precedingText 、 precedingChar 、 isSeparator 


e varName 匹配 结果 会 将 路 由 参数 提取 出 来 ， 本 例 中 : foo ^ baz ^ ext 
e precedingText 是 两 个 路 由 参数 之 间 的 字符 串 ， 本 例 
中 : prefix/ 、/、 
e precedingChar 是 每 个 路 由 参数 之 前 的 字符 ， 也 就 是 precedingText 的 
Ee -—4APARODR:ESEMC 
e isSeparator 判断 precedingchar =@ url 的 间隔 符 ， 本 例 


中 : true 、 true ^ true 


tokens-text 


将 precedingText 记录 进 tokens 数组 ，key A text ° 第 一 次 循环 ， 
tokens : 


tokens = array ( 
9 = text, 
1 - prefix, 


) 
第 二 次 循环 与 第 三 次 循环 由 于 precedingText == precedingChar ， 所 以 并 不 
会 记录 。 


构建 regexp 


若 在 路 由 定义 的 过 程 中 利用 where 属性 或 者 pattern 为 路 由 的 参数 设置 正则 
约束 ， 那 么 此 时 就 会 将 约束 规则 赋 给 regexp ， 否 则 就 会 启用 构建 regexp 的 过 


程 : 


$followingPattern = (string) substr($pattern, $pos); 
$nextSeparator = self::findNextSeparator($followingPattern, $use 
Utf8); 


$regexp = sprintf( 
' [^%s%s]+', 
preg_quote($defaultSeparator, self::REGEX DELIMITER) 


$defaultSeparator !-- $nextSeparator && '' !-- $next 
Separator ? preg quote($nextSeparator, self::REGEX DELIMITER) 


); 


if (('' !== $nextSeparator && !preg_match('#4\{\w+\}#', $followi 
ngPattern)) || '' === $followingPattern) { 

$regexp .= '*'; 
} 


构建 regexp 有 两 个 部 分 ， 


e 了 寻找 nextSeparator 


private static function findNextSeparator($pattern, $useUtf8) 


i 


if ('' == $pattern) { 
return ''; 
} 
if ('' === $pattern = preg_replace('#\{\w+\}#', '', $pattern 
)) I 
return ua 
J; 
return false !-- strpos(static::SEPARATORS, $pattern[0]) ? $ 
pattern[0] : ''; 


j 


这 个 函数 的 意义 在 于 为 路 由 的 uri 的 路 由 参数 寻找 非 默认 间隔 符 ， 例 如 ， 路 由 可 


以 这 样 设 置 uri 
/{baz}.{ext}/ 


默认 的 间隔 符 就 是 / ， 如 果 不 设 置 非 默 认 间 隔 符 的 时 候 ， 那 么 regexp = 

[^/] > mobile.html 这 样 的 请 求 就 会 被 {baz} 这 个 参数 全 部 匹配 

到 ， {ext} 就 没有 任何 参数 来 对 应 。 设 置 了 非 默 认 间 隔 符 后 regexp = [^/.] , 
baz 就 会 匹配 mobile ， ext 就 会 匹配 html 。 


e 侵占 型 正则 表达 式 


if (('' !== $nextSeparator && !preg_match('#^\{\w+\}#', $followi 
ngPattern)) || '' === $followingPattern) { 

$regexp .= '*'; 
} 


为 了 减少 贪 禁 型 正则 表达 式 的 回溯 导致 的 性 能 浪费 ， 当 后 续 字符 串 已 经 结束 或 者 不 
存在 /{x}{y} 这 样 情况 的 时 候 ， 程 序 将 贪 禁 型 正则 表达 式 改 为 侵占 型 正则 表达 
式 。 有 关 正 则 表达 式 的 模式 请 查看 : 正则 表达 式 之 贪 禁 与 非 贪 焚 模 式 详解 (概述 ) 


tokens-variable 


获取 路 由 参数 和 正则 表达 式 之 后 ， 就 要 更 新 tokens ,分 别 将 isSeparator , 
regexp , varName 更 新 到 结果 数组 中 。 


以 prefix/{foo}/{baz}.{ext}/tail 为 例 ，$tokens 在 各 个 循环 时 值 为 : 


$tokens = array ( 
0 = array ( 
0 = ‘text’, 
1 = '/prefix' 


) 
1 = array ( 
9 = ‘variable’, 
te 
C= pA, 
1 = 'foo' 


)// 第 一 次 循环 结 ， 
2= array ( 


0 = ‘variable’, 
ety, 
0 = paz quer 
t= haz 
)// 第 二 次 循环 结 ; 
3 = array ( 
9 = ‘variable’, 
JE 
Qu pA as 
d= TEKE” 
)// E. 
4 - array ( 
9 = 'text', 
1 = '/tail' 


Wee 循环 外 


默认 路 由 参数 


接 下 来 就 要 计算 首 个 默认 路 由 参数 在 整个 路 由 url 的 人 位置， 以便 在 生成 正则 表达 
式 中 使 用 : 


$firstOptional = PHP INT MAX; 
if (!$isHost) { 
for ($i = count($tokens) - 1; $i >= 0; --$i) { 
$token = $tokens[$i]; 


if ('variable' === $token[0] && $route->hasDefault ($toke 
n[3])) t 
$firstOptional - $i; 
} else { 
break; 
} 
} 
} 
计算 正则 表达 式 
所 有 的 tokens 数组 都 构建 完毕 ， 接 下 来 就 需要 利用 这 个 数组 来 构建 正则 表达 式 
了 o 
$regexp = ''; 


for ($i = 0, $nbToken = count($tokens); $i < $nbToken; ++$i) { 
$regexp .= self::computeRegexp($tokens, $i, $firstOptional); 

} 

$regexp = self::REGEX DELIMITER.'^'.$regexp.'$'.self: :REGEX_DELI 

METER. Si (hishost 2 


private static function computeRegexp(array $tokens, $index, 
$firstOptional ) 
{ 
$token = $tokens[$index]; 
if ('text' === $token[0]) { 
// Text tokens 
return preg_quote($token[1], self::REGEX_DELIMITER); 


} else { 
// Variable tokens 
if (0 === $index && 0 === $firstOptional) { 


// When the only token is an optional variable t 
oken, the separator is required 
return sprintf('%s(?P<%s>%s)?', preg_quote($toke 
n[1], self::REGEX_DELIMITER), $token[3], $token[2]); 
) else { 
$regexp = sprintf('%s(?P<%s>%s)', preg_quote($to 
ken[1], self::REGEX DELIMITER), $token[3], $token[2]); 
if ($index >= $firstOptional) { 
$regexp = "(?:$regexp"; 
$nbTokens = count($tokens); 
if ($nbTokens - 1 == $index) { 
// Close the optional subpatterns 
$regexp .= str_repeat(')?', $nbTokens - 
$firstOptional - (0 === $firstOptional ? 1 : 0)); 
} 


return $regexp; 


computeRegexp 函数 的 大 致 流程 为 : 


e & tokens 当前 元 素 是 text ， 不 是 路 由 参数 的 时 候 ， 直 接 赋 值 原 字 符 串 
Bp oy 

e X url 中 路 由 参数 都 是 可 选 参 数 ， 且 没有 任何 text ， 那 么 第 一 个 可 选 参 
数 使 用 捕获 分 组 

e 若 当 前 路 由 参数 是 可 选 参数 的 时 候 ， 需 要 在 正则 表达 式 中 不 断 重 加 非 捕 获 分 组 


(? ， 再 最 后 设置 为 可 选 分 组 )? ， 例 如 (?:/(?P«baz»[^/]*9) (?:/(? 
p<ext>[^/]++))?)? 
e 若 当 前 路 由 参数 不 是 可 选 参 数 的 时 候 ， 正 则 表达 式 就 是 固定 模式 ， 例 如 : 
/(?P<foo>[^/]++) 


利用 computeRegexp 函数 拼接 正则 表达 式 后 ， 还 要 在 最 两 侧 分 隔 符 、 开 始 符 
^ ,结束 符 $ 、 单 行 修 正 符 s ， 如 果 是 主 域 的 正则 表达 式 ， 还 要 添加 不 区 分 大 
小 写 的 修正 符 i^e 


以 prefix/{foo}/{baz}.{ext}/tail 为 例 ,每 次 生成 的 正则 表达 式 如 下 


/prefix 

/prefix/(?P<foo>[4/]++) 
/prefix/(?P<foo>[4/]++)/(?P<baz>[4/\.]++) 
/prefix/(?P<foo>[4/]++)/(?P<baz>[4/\.]++)\. (?P<ext>[4/]++) 
/prefix/(?P<foo>[4/]++)/(?P<baz>[4/\.]++)\. (?P<ext>[A4/]++)/tail 
#\/prefix/(?P<foo>[4/]++)/(?P<baz>[4/\. ]++)\. (?P<ext>[4/]++)/tai 
1$#s 


以 {f00?}/{baz?}.{ext?} 为 例 ,每 次 生成 的 正则 表达 式 如 下 


/(?P<foo>[^/]++)? 

/ (?P«foo»[^/]*-)?(?:/(?P«baz»[^/N.]**) 

/ (?P«foo»[^/]*-)?(?:/(?P«baz»[^/N.]**) (?:N. (?P«ext» [^/]**))?)? 
4^7ztoPeéfoo»[^/7]erF)?(2?*7(2Psbaz»[^7N- |++)( 22 NS (?PSexto [^7 T5R.))2)2 
$#s 


月 &@ 
上 一 篇 文章 我 们 说 到 路 由 的 正则 编译 ， 正 则 编译 的 目的 就 是 和 请 求 的 url 来 匹 
配 ， 只 有 匹配 上 的 路 由 才 是 我 们 站 正 想 要 的 ， 此 外 也 会 通过 正则 匹配 来 获取 路 由 的 


参数 。 


路 由 的 匹配 


路 由 进行 正则 编译 后 ， 就 要 与 请 求 request 来 进行 正则 匹配 ， 并 且 进 行 一 些 验 
q 
HostValidator 


^ 


^ 


十 ， 例 如 
UriValidator ^ MethodValidator SchemeValidator 
IteratorAggregate 


o 


class RouteCollection implements Countable, 


( 


public function match(Request $request) 
{ 
= $this->get($request ->getMethod()); 


$routes 
$this->matchAgainstRoutes($routes, $request); 


$route 
if (! is null($route)) (1 
return $route->bind($request); 


} 
$this->checkForAlternateVerbs($request); 


$others 
if (count($others) > 0) ( 
return $this->getRouteForMethods($request, $others); 
throw new NotFoundHttpException; 
} 
protected function matchAgainstRoutes(array $routes, $reques 


t, $includingMethod = true) 


return Arr::first($routes, function ($value) use ($r 
equest, $includingMethod) { 
return $value->matches($request, $includingMethod) ; 


3); 


class Route 


{ 
public function matches(Request $request, $includingMethod = 
true) 


€ 


$this->compileRoute(); 


foreach ($this->getValidators() as $validator) { 
if (! $includingMethod && $validator instanceof Meth 
odValidator) { 


continue; 


if (! $validator->matches($this, $request)) ( 
return false; 


cetur erue; 


public static function getValidators() 
{ 
if (isset(static::$validators)) { 
return static::$validators; 


return static::$validators = [ 
new UriValidator, new MethodValidator, 
new SchemeValidator, new HostValidator, 


1; 


UriValidator uri 验证 
UriValidator 验证 主要 是 目的 是 查看 路 由 正则 与 请 求 是 否 匹 配 : 


class UriValidator implements ValidatorInterface 


{ 
public function matches(Route $route, Request $request ) 
{ 
$path = $request->path() == '/' ? '/' : '/'.$request-»pa 
th(); 


return preg_match($route->getCompiled()->getRegex(), raw 
urldecode($path) ); 


} 


值得 注意 的 是 ， 在 匹配 路 径 之 前 ， 程 序 使 用 了 rawurldecode 来 对 请 求 进 行 解 
dd 


MethodValidator 验证 
请 求 方法 验证 : 


class MethodValidator implements ValidatorInterface 


1 


public function matches(Route $route, Request $request) 


{ 


return in_array($request->getMethod(), $route-»methods() 


SchemeValidator 了 验证 


路 由 scheme 协议 验证 : 


class SchemeValidator implements ValidatorInterface 


i 


public function matches(Route $route, Request $request) 


{ 
if ($route->httpOnly()) ( 
return ! $request->secure(); 
} elseif ($route->secure()) { 
return $request-»secure( ); 
} 
return true; 
} 
} 
public function httpOnly() 
{ 
return in array('http', $this->action, true); 
j 
public function secure() 
{ 
return in_array('https', $this->action, true); 
} 


HostValidator 验证 


主 域 验证 : 


class HostValidator implements ValidatorInterface 


{ 


public function matches(Route $route, Request $request) 


{ 
if (is_null($route->getCompiled()->getHostRegex())) { 
return true; 


return preg_match($route->getCompiled()->getHostRegex(), 
$request->getHost()); 
} 


也 就 是 说 ， 如 果 路 由 中 并 不 设置 host 属性 ， 那 么 这 个 验证 并 不 进行 。 


路 由 的 参数 绑 定 


一 旦 菜 个 路 由 符合 请 求 的 uri 四 项 认证 ， 就 将 会 被 返回 ， 接 下 来 就 要 对 路 由 的 参 
数 进行 绑 定 与 赋值 : 


class RouteCollection implements Countable, IteratorAggregate 


{ 


public function bind(Request $request ) 


{ 
$this-»compileRoute(); 
$this->parameters = (new RouteParameterBinder ($this) ) 
-»parameters($request); 
return $this; 
} 


bind BAA TBHARSAR url 的 绑 定 工作 : 


class RouteParameterBinder 


{ 
public function parameters($request) 
{ 
$parameters = $this->bindPathParameters($request); 
if (! is_null($this->route->compiled->getHostRegex())) { 
$parameters = $this->bindHostParameters( 
$request, $parameters 
); 
} 
return $this->replaceDefaults($parameters) ; 
} 
} 


可 以 看 出 ， 路 由 参数 绑 定 分 为 主 域 参 数 绑 定 与 路 径 参 数 绑 定 ， 我 们 先 看 路 径 参 数 绑 
z: 


BIRARE 


class RouteParameterBinder 


{ 


protected function bindPathParameters($request) 


{ 
preg_match($this->route->compiled->getRegex(), '/'.$ 
request->decodedPath(), $matches); 


return $this->matchToKeys(array_slice($matches, 1)); 


例如 ， {foo}/{baz?}.{ext?} 进行 正则 编译 后 结果 : 


#\/(?P<foo>[4/]++) (?:/(?P<baz>[A4/\. ]++)(?:\. (?P<ext>[4/]++) )?)?$ 
#S 


其 与 request 匹配 后 的 结果 为 : 


$matches = array (人 


om E noo baz exti 
Io a ooi, 
foo = "foo", 
2 = "baz", 
baz = "baz", 
d. = "ext", 
Sku a ex 


array_slice($matches, 1) 取出 了 $matches 数组 1 之 后 的 结果 ， 然 后 调用 
了 matchToKeys 函数 ， 


protected function matchToKeys(array $matches) 


( 


if (empty($parameterNames = $this-»route-»parameterNames()) 


) i 


return []; 
$parameters = array intersect key($matches, array flip($para 
meterNames)); 
return array filter($parameters, function ($value) { 


return is string($value) && strlen($value) > 0; 


3); 


该 函数 中 利用 正则 获取 了 路 由 的 所 有 参数 : 


class Route 


{ 
public function parameterNames() 
{ 
if (isset($this->parameterNames)) { 
return $this->parameterNames; 
} 
return $this->parameterNames = $this->compileParameterNa 
mes(); 
} 


protected function compileParameterNames() 


t 
preg_match_all('/\{(.*?)\}/', $this->domain().$this->uri 


, $matches); 


return array map(function ($m) { 
return trim($m, '?'); 
), $matches[1]); 


可 以 看 出 ， 获 取 路 由 参数 的 正则 表达 式 采 用 了 勉强 模式 ， 意 图 提取 出 所 有 的 路 由 参 
A~ Ak 


数 。 否 则 ， 对 于 路 由 {foo}/{baz?}. {ext?} , 贪 禁 型 正则 表达 式 /\{(.*)\}/ 
将 会 匹配 整个 字符 串 ， 而 不 是 各 个 参数 分 组 。 


提取 出 的 参数 结果 为 : 


$matches = array ( 
© = array ( 
09 = "{foo}". 
1o 4 baze 
2= “fext? 


) 

1 = array ( 
0 = "foo". 
Le paro 
2E Eee 

) 


得 出 的 结果 将 会 去 除 $matches[1] ， 并 且 将 会 删除 结果 中 最 后 的 ? 


o 


之 后 ， 在 matchToKeys 函数 中 ， 


$parameters = 


array_intersect_key($matches, array flip(S$paramete 
rNames)); 


获取 了 匹配 结果 与 路 由 所 有 参数 的 交集 : 


$parameters = array ( 


foo = "foo", 
baz = "baz", 
ext = "ext", 


主 域 参 数 绑 定 


protected function bindHostParameters($request, $parameters) 


{ 


preg_match($this->route->compiled->getHostRegex(), $request- 
>getHost(), $matches); 


return array_merge($this->matchToKeys(array_slice($matches, 1 
)), $parameters); 


) 
‘| | 





步骤 与 路 由 参数 绑 定 一 致 。 


替换 默认 值 


， 有 一 些 可 选 参 数 并 没有 在 request 中 匹配 到 ， 这 时 候 就 要 用 可 
选 参 数 的 默认 值 添加 到 变量 parameters 中 : 


protected function replaceDefaults(array $parameters) 


{ 


foreach ($parameters as $key => $value) { 
$parameters[$key] = isset($value) ? $value : Arr::get($t 
his->route->defaults, $key); 


} 


foreach ($this->route->defaults as $key => $value) { 
if (! isset($parameters[$key])) { 
$parameters[$key] = $value; 


return $parameters; 


匹配 异常 处 理 


如 果 url 匹配 失败 ， 没 有 找到 任何 路 由 与 请 求 相 互 匹 配 ， 就 会 切换 method Zr 
法 ， 以 来 任意 路 由 来 匹配 : 


protected function checkForAlternateVerbs($request ) 
{ 

$methods = array_diff(Router::$verbs, [$request->getMethod( ) 
1); 


$others - []; 


foreach ($methods as $method) { 
if (! is null($this-»matchAgainstRoutes($this-»get($meth 
od), $request, false))) { 
$others[] = $method; 


return $others; 


如 果 使 用 其 他 方法 匹配 成 功 ， 就 要 判断 当前 方法 是 否 是 options °? PREM AH 
返回 ， 否 则 报 出 异常 : 


protected function getRouteForMethods($request, array $methods) 
if ($request->method() == 'OPTIONS') { 
return (new Route('OPTIONS', $request->path(), function 
() use ($methods) { 
return new Response('', 200, ['Allow' => implode(', ' 
, $methods)]); 
}))->bind($request); 


$this->methodNotAllowed($methods ) ; 


protected function methodNotAllowed(array $others) 


1 
throw new MethodNotAllowedHttpException(S$others); 


当 进 行 了 路 由 匹配 与 路 由 参数 绑 定 后 ， 接 下 来 就 要 进行 路 由 闭 包 或 者 控制 器 的 运 
行 ， 在 此 之 前 ， 本 文 先 介绍 中 间 件 的 相关 源码 。 


中 间 件 的 搜集 


由 于 定义 的 中 间 件 方式 很 灵活 ， 所 以 在 运行 控制 器 或 者 路 由 闭 包 之 前 ， 我 们 需要 先 
将 在 各 个 地 方 注册 的 所 有 中 间 件 都 搜集 到 一 起 ， 然 后 集中 排序 。 


public function dispatchToRoute(Request $request) 


{ 

$route = $this->findRoute($request); 

$request ->setRouteResolver(function () use ($route) { 

return $route; 

3); 

$this->events->dispatch(new Events\RouteMatched($route, $req 
uest)); 

$response = $this->runRoutewithinStack($route, $request); 

return $this->prepareResponse($request, $response); 
} 
protected function runRouteWithinStack(Route $route, Request $re 
quest) 
t 


$shouldSkipMiddleware = $this->container->bound('middleware. 


disable') && 
$this->container ->make( 'middleware.d 


isable') === true; 


$middleware = $shouldSkipMiddleware ? [] : $this->gatherRout 
eMiddleware($route) ; 


return (new Pipeline($this->container ) ) 

->send($request ) 

-»through($middleware) 

->then(function ($request) use ($route) { 
return $this->prepareResponse( 

$request, $route->run() 

); 

3); 


public function gatherRouteMiddleware(Route $route) 
{ 
$middleware = collect($route->gatherMiddleware())->map(funct 
ion ($name) { 
return (array) MiddlewareNameResolver::resolve($name, $t 
his->middleware, $this->middlewareGroups) ; 
})->flatten(); 


return $this->sortMiddleware($middleware) ; 


路 由 的 中 间 件 大 致 有 两 个 大 的 来 源 : 


e 在 路 由 的 定义 过 程 中 ， 利 用 关键 字 middleware 为 路 由 添加 中 间 件 ， 这 种 中 
间 件 都 是 在 文件 App\Http\Kernel 中 $middlewareGroups 
^ $routeMiddleware 这 两 个 数组 定义 的 中 间 件 别名 。 

e 在 路 由 控制 器 的 构造 函数 中 ， 添 加 中 间 件 ， 可 以 在 这 里 定义 一 个 闭 包 作为 中 间 
件 ， 也 可 以 利用 中 间 件 别名 。 


public function gatherMiddleware( ) 


1 
if (! is_null($this->computedMiddleware)) { 
return $this->computedMiddleware; 
J 
$this->computedMiddleware = []; 
return $this->computedMiddleware = array_unique(array_merge( 
$this->middleware(), $this->controllerMiddleware( ) 
), SORT REGULAR); 
jy 


路 由 定义 的 中 间 件 是 从 action 数组 中 取出 来 的 : 


public function middleware($middleware = null) 


{ 
if (is_null($middleware)) { 
return (array) Arr::get($this->action, 'middleware', []) 


if (is_string($middleware)) { 
$middleware = func_get_args(); 


$this->action[ 'middleware'] = array merge( 
(array) Arr::get($this->action, 'middleware', []), $midd 
leware 


); 


return $this; 


控制 器 定义 的 中 间 件 : 


public function controllerMiddleware( ) 


{ 
if (! $this->isControllerAction()) { 
return []; 
} 
return ControllerDispatcher::getMiddleware( 
$this->getController(), $this-»getControllerMethod() 
); 
} 
public function getController() 
{ 
$class = $this->parseControllerCallback()[0]; 
if (! $this->controller) { 
$this->controller = $this->container->make($class); 
} 
return $this->controller; 
} 
protected function getControllerMethod() 
{ 
return $this->parseControllerCallback()[1]; 
j 
protected function parseControllerCallback() 
{ 
return Str: :parseCallback($this->action['uses']); 
} 


public static function parseCallback($callback, $default = null) 
{ 

return static::contains($callback, '@') ? explode('@', $call 
back, 2) : [$callback, $default]; 


j 


当前 的 路 由 如 果 使 用 控制 器 的 时 候 ， 就 要 解析 属性 use ， 解 析出 控制 器 的 类 名 与 
类 方法 。 接 下 来 就 需要 ControllerDispatcher AX» 


在 讲解 ControllerDispatcher 类 之 前 ， 我 们 需要 先 了 解 一 下 控制 器 中 间 件 : 


abstract class Controller 


{ 
public function middleware($middleware, array $options = []) 
i 
foreach ((array) $middleware as $m) ( 
$this->middleware[] = [ 
'middleware' => $m, 
'options' => &$options, 
l; 
} 
return new ControllerMiddlewareOptions($options); 
J 
} 


class ControllerMiddlewareOptions 


{ 


protected $options; 


public function __construct(array &$options) 


| 


$this->options = &$options; 


public function only($methods) 
t 


$this-»options['only'] = is array($methods) ? $methods : 
func. get args(); 


return $this; 


public function except($methods) 


( 


$this-»options['except'] = is array($methods) ? $methods 


: func_get_args(); 


return $this; 


在 为 控制 器 定义 中 间 的 是 ， 可 以 为 中 间 件 利用 only 指定 在 当前 控制 器 中 调用 该 
— 器 方法 ， 也 可 以 利用 except 指定 在 当前 控制 器 禁止 调用 中 间 
件 的 方法 。 这 些 信 息 都 保存 在 控制 器 的 变量 middleware 的 options 中 。 


在 搜集 控制 器 的 中 间 件 时 ， 就 要 利用 中 间 件 的 这 些 信息 : 


class ControllerDispatcher 


{ 


public static function getMiddleware($controller, $method) 


{ 
if (! method_exists($controller, 'getMiddleware')) { 


return []; 


return collect($controller ->getMiddleware())->reject(fun 


ction ($data) use ($method) { 
return static: :methodExcludedByOptions($method, $dat 


a['options']); 
))-»pluck('middleware')-»all(); 


protected static function methodExcludedByOptions($method, a 
rray $options) 


{ 
return (isset($options['only']) && ! in array($method, ( 


array) $options['only'])) || 
(! empty($options['except']) && in array(S$method, (a 


rray) Soptions['except'])); 
} 


在 ControllerDispatcher 类 中 ， 利 用 了 reject 函数 对 每 一 个 中 间 件 都 进行 
了 控制 器 方法 的 判断 ， 排 除了 不 支持 该 控制 器 方法 的 中 间 件 。 pluck 函数 获取 了 
控制 器 $this->middleware[] 数组 中 middleware 的 所 有 元 素 。 


中 间 件 的 解析 
中 间 件 解析 主要 的 工作 是 将 路 由 中 中 间 件 的 别名 转化 为 中 间 件 全 程 ， 主 要 流程 为 : 


class MiddlewareNameResolver 


{ 
public static function resolve($name, $map, $middlewareGroup 
S) 
{ 
if ($name instanceof Closure) { 
return $name; 
} elseif (isset($map[$name]) && $map[$name] instanceof C 
losure) { 


return $map[$name]; 


} elseif (isset($middlewareGroups[$name])) { 
return static: :parseMiddlewareGroup( 
$name, $map, $middlewareGroups 


); 


) else { 
list($name, $parameters) = array_pad(explode(':', $n 
ame, 2), 2, null); 


return (isset($map[$name]) ? $map[$name] : $name). 
(! is_null($parameters) ? ':'.$parameters : 
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可 以 看 出 ， 解 析 的 中 间 件 对 象 有 三 种 : 闭 包 、 中 间 件 别名 、 中 间 件 组 。 


e 对 于 闭 包 来 说 ， resolve 直接 返回 闭 包 ; 

e 对 于 中 间 件 别名 来 说 ， 例 如 auth ， 会 从 App\Http\Kernel 文件 
$routeMiddleware 数组 中 寻找 中 间 件 全 名 
NIlluminateNAuthNMiddlewareNAuthenticate::class 

e 对 于 具有 参数 的 中 间 件 别名 来 说 ， 例 如 throttle:60,1 ,会 将 别名 转化 为 全 

名 \Illuminate\Routing\Middleware\ThrottleRequests::60,1 

e 对 于 中 间 件 组 来 说 ， 会 调用 parseMiddlewareGroup ako 


protected static function parseMiddlewareGroup($name, $map, $mid 
dlewareGroups) 


{ 
$results = []; 


foreach ($middlewareGroups[$name] as $middleware) { 
if (isset($middlewareGroups[$middleware])) { 
$results = array_merge($results, static::parseMiddle 
wareGroup ( 
$middleware, $map, $middlewareGroups 


)); 


continue; 


list($middleware, $parameters) = array_pad( 
explode(':', $middleware, 2), 2, null 

); 

if (isset($map[$middleware])) { 


$middleware = $map[$middleware]; 


$results[] = $middleware.($parameters ? ':'.$parameters 


return $results; 


可 以 看 出 ， 对 于 中 间 件 组 来 说 ， 就 要 从 App\Http\Kernel 文件 
$$middlewareGroups 数组 中 寻找 组 内 的 多 个 中 间 件 ， 例 如 中 间 件 组 api 


'api' => [ 
“throlL ele: corii 
'bindings', 


解析 出 的 中 间 件 可 能 存在 参数 ， 别 名 转化 为 全 名 后 函数 返回 。 值 得 注意 的 是 ， 中 间 
件 组 内 不 一 定 都 是 别名 ， 也 有 可 能 是 中 间 件 组 的 组 名 ， 例 如 : 


'api' => [ 
"Ehrottle:69, iir 
'web', 


'web' => [ 
NAppNHttpNMiddlewareNEncryptCookies::class, 
\Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse: :cl 
ass, 


], 


这 时 ， 就 需要 选 代 解析 。 


中 间 件 的 排序 


public function gatherRouteMiddleware(Route $route) 
{ 
$middleware = collect($route->gatherMiddleware())->map(funct 
ion ($name) { 
return (array) MiddlewareNameResolver::resolve($name, $t 
his->middleware, $this->middlewareGroups) ; 
})->flatten(); 


return $this->sortMiddleware($middleware) ; 


将 所 有 中 间 件 搜集 并 解析 完毕 后 ， 接 下 来 就 要 对 中 间 件 的 调用 顺序 做 一 些 调整 ， 以 
确保 中 间 件 功能 正常 。 


protected $middlewarePriority = [ 
\Illuminate\Session\Middleware\StartSession::class, 
NIlluminateNViewNMiddlewareNShareErrorsFromSession::class, 
NIlluminateNAuthNMiddlewareNAuthenticate::class, 
NIlluminateNSessionNMiddlewareNAuthenticateSession::class, 
NIlluminateNRoutingNMiddlewareNSubstituteBindings::class, 
NIlluminateNAuthNMiddlewareNAuthorize::class, 


l; 


数组 middlewarePriority 中 保存 着 必须 有 一 定 顺 序 的 中 间 件 ， 例 如 
Startsession 中 间 件 就 必须 运行 在 ShareErrorsFromSession 之 前 。 因 此 一 
旦 路 由 中 有 这 两 个 中 间 件 ， 那 么 就 要 确保 两 者 的 顺序 一 致 。 


中 间 件 的 排序 由 函数 sortMiddleware 负责 : 


class SortedMiddleware extends Collection 


{ 
public function __construct(array $priorityMap, $middlewares) 
{ 
if ($middlewares instanceof Collection) { 
$middlewares = $middlewares-»all(); 
} 
$this->items = $this->sortMiddleware($priorityMap, $midd 
lewares); 
j 


protected function sortMiddleware($priorityMap, $middlewares) 


$lastIndex = 0; 


foreach ($middlewares as $index => $middleware) { 
if (! is_string($middleware)) { 
continue; 


$stripped = head(explode(':', $middleware) ); 


if (in_array($stripped, $priorityMap)) { 
$priorityIndex = array_search($stripped, $priori 
tyMap); 


if (isset($lastPriorityIndex) && $priorityIndex 
« $lastPriorityIndex) { 
return $this->sortMiddleware( 
$priorityMap, array_values( 
$this->moveMiddleware($middlewares, 
$index, $lastIndex) 


); 

) else { 
$lastIndex = $index; 
$lastPriorityIndex = $priorityIndex; 


return array_values(array_unique($middlewares, SORT REGU 
LAR)); 


} 


protected function moveMiddleware($middlewares, $from, $to) 
t 
array splice($middlewares, $to, 0, $middlewares[$from]); 


unset($middlewares[$from + 1]); 


return $middlewares; 








苞 数 的 方法 很 简单 ， 检 测 当 前 中 间 件 数组 ， 查 看 是 否 存 在 中 间 件 是 数组 
middlewarePriority 内 元 素 。 如 果 发 现 了 两 个 中 间 件 不 符合 顺序 ， 那 么 就 要 调 
换 中 间 件 顺序 ， 然 后 进行 迭代 。 


当 路 由 与 请 求 进行 正则 匹配 后 ， 各 个 路 由 的 参数 就 获得 了 它们 各 自 的 数值 。 然 而 ， 
有 些 路 由 参数 变量 ， 我 们 还 想 要 把 它 转化 为 特定 的 对 象 ， 这 时 候 就 需要 中 间 件 的 帮 
助 。 SubstituteBindings 中 间 件 就 是 一 个 将 路 由 参数 转化 为 特定 对 象 的 组 件 ， 
它 默 认可 以 将 特定 名 称 的 路 由 参数 转化 数据 库 模型 对 象 ， 可 以 转化 已 绑 定 的 路 由 参 
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SubstituteBindings 中 间 件 的 使 用 
数据 库 模 型 隐 性 转化 


首先 我 们 定义 了 一 个 带 有 路 由 参数 的 路 由 : 


Route::put('user/(userid)', 'UserController@update' ); 


然后 我 们 在 路 由 的 控制 器 方法 中 或 者 路 由 闭 包 函数 中 定义 一 个 数据 库 模型 类 型 的 参 
数 ， 这 个 参数 名 与 路 由 参数 相同 : 


class UserController extends Controller 


{ 
public function update(UserModel $userid) 
{ 
$userid->name = 'taylor'; 
$userid->update(); 
} 
} 


这 时 ， 路 由 的 参数 会 被 中 间 件 隐 性 地 转化 为 UserModel ， 且 模型 变量 $userid 
的 主键 值 为 参数 变量 {userid} 正则 匹配 后 的 数值 。 


综合 测试 样 例 : 


public function testImplicitBindingsWithOptionalParameter() 


Laravel HTTP——SubstituteBindings 参数 绑 定 中 间 件 的 使 用 与 源码 解析 


unset($_SERVER['__test.controller_callAction_parameters']); 
$router->get(($str = str_random()).'/{user}/{defaultNull?}/{ 
team?}', [ 
'middleware' => SubstituteBindings::class, 
'uses' => 'IlluminateNTestsNRoutingNRouteTestAnotherCont 
rollerwithParameterStubQwithModels', 


1); 
$router->dispatch(Request::create($str.'/1', 'GET')); 


$values = array values($ SERVER[' ktest.controller callActio 
n parameters']); 


$this->assertEquals(i, $values[0]->value); 


class RouteTestAnotherControllerwithParameterStub extends Contro 
ller 
1 


public function callAction($method, $parameters) 


{ 
$_SERVER[ ' test.controller callAction parameters'] = $p 


arameters, 


} 

public function withModels(RoutingTestUserModel $user) 

{ 

} 
} 
class RoutingTestUserModel extends Model 
{ 

public function getRouteKeyName( ) 

{ 

return ud 
} 


public function where($key, $value) 
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$this->value = $value; 


return $this; 


} 
public function first() 
{ 
return $this; 
} 
public function firstOrFail() 
{ 
return $this; 
} 


路 由 显示 绑 定 


除了 隐 示 地 转化 路 由 参数 外 ， 我 们 还 可 以 给 路 由 参数 显示 提供 绑 定 。 显 示 绑 定 有 
bind 、 model 两 种 方法 。 


e 通过 bind 为 参数 绑 定 闭 包 函 数 : 


public function testRouteBinding() 
1 
$router = $this->getRouter(); 
$router->get('foo/{bar}', ['middleware' => SubstituteBinding 
s::class, 'uses' => function ($name) { 
return $name; 
31); 
$router->bind('bar', function ($value) ( 
return strtoupper ($value); 
3): 
$this->assertEquals('TAYLOR', $router->dispatch(Request::cre 
ate('foo/taylor', 'GET'))-»getContent()); 


} 


e 通过 bind 为 参数 绑 定 类 方法 ， 可 以 指定 classname@method ， 也 可 以 直 
接 使 用 类 名 ， 默 认 会 调用 类 的 bind BA: 


public function testRouteClassBinding( ) 
{ 

$router = $this->getRouter(); 

$router->get('foo/{bar}', ['middleware' => SubstituteBinding 
s::class, 'uses' => function ($name) { 

return $name; 

31); 

$router->bind('bar', 'IlluminateNTestsNRoutingNRouteBindingS 
tub'); 

$this->assertEquals('TAYLOR', $router->dispatch(Request::cre 
ate('foo/taylor', 'GET'))-»getContent()); 
} 


public function testRouteClassMethodBinding( ) 
{ 

$router = $this->getRouter(); 

$router->get('foo/{bar}', ['middleware' => SubstituteBinding 
s::class, 'uses' => function ($name) { 

return $name; 

31); 

$router->bind('bar', 'IlluminateNTestsNRoutingNRouteBindingS 
tub@find'); 

$this->assertEquals('dragon', $router->dispatch(Request::cre 
ate('foo/Dragon', 'GET'))->getContent()); 


} 
class RouteBindingStub 
{ 
public function bind($value, $route) 
{ 
return strtoupper($value); 
} 
public function find($value, $route) 
{ 
return strtolower($value); 
} 


过 model 为 参数 绑 定 数据 库 模 型 ， 路 由 的 参数 就 不 需要 和 控制 器 方法 中 的 


变量 名 相同 ， laravel 会 利用 路 由 参数 的 值 去 调用 where 方法 查找 对 应 记 
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if ($model = $instance->where($instance->getRouteKeyName(), $val 
ue)->first()) { 
return $model; 


测试 样 例 如 下 : 


public function testModelBinding( ) 
{ 

$router = $this->getRouter(); 

$router->get('foo/{bar}', ['middleware' => SubstituteBinding 
s::class, 'uses' => function ($name) { 

return $name; 

31); 

$router->model('bar', 'IlluminateNTestsNRoutingNRouteModelBi 
ndingStub'); 

$this->assertEquals('TAYLOR', $router->dispatch(Request::cre 
ate('foo/taylor', 'GET'))-»getContent()); 


} 
class RouteModelBindingStub 
{ 
public function getRouteKeyName( ) 
{ 
return 'id'; 
} 
public function where($key, $value) 
{ 
$this->value = $value; 
return $this; 
} 
public function first() 
{ 
return strtoupper($this->value); 
} 
} 


e 若 绑 定 的 model 并 没有 找到 对 应 路 由 参数 的 记录 ， 可 以 在 model 中 定义 
一 个 闭 包 函数 ， 路 由 参数 会 调用 闭 包 函数 : 


public function testModelBindingwithCustomNullReturn() 


{ 
$router = $this->getRouter(); 
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$router->get('foo/{bar}', ['middleware' => SubstituteBinding 
s::class, 'uses' => function ($name) { 
return $name; 
31); 
$router->model('bar', 'IlluminateNTestsNRoutingNRouteModelBi 
ndingNullstub’, function () 4 
return 'missing'; 
3); 
$this->assertEquals('missing', $router->dispatch(Request: :cr 
eate('foo/taylor', 'GET'))->getContent()); 
} 


public function testModelBindingWithBindingClosure() 
1 
$router = $this->getRouter(); 
$router->get('foo/{bar}', ['middleware' => SubstituteBinding 
s::class, 'uses' => function ($name) { 
return $name; 
31); 
$router->model('bar', 'IlluminateNTestsNRoutingNRouteModelBi 
ndingNullStub', function ($value) { 
return (new RouteModelBindingClosureStub())-»findAlterna 
te($value); 
3); 
$this->assertEquals('tayloralt', $router-»dispatch(Request:: 
create('foo/TAYLOR', 'GET'))-»getContent()); 


j 
class RouteModelBindingNullStub 
{ 
public function getRouteKeyName( ) 
{ 
return 'id'; 
} 
public function where($key, $value) 
{ 
return $this; 
} 
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public function first() 


{ 
} 
} 
class RouteModelBindingClosureStub 
{ 
public function findAlternate($value) 
{ 
return strtolower($value).'alt'; 
} 
} 


SubstituteBindings 中 间 件 的 源码 解析 


class SubstituteBindings 


{ 
public function handle($request, Closure $next) 
{ 
$this->router->substituteBindings($route = $request->rou 
te()); 
$this->router ->substituteImplicitBindings($route); 
return $next($request); 
} 
} 


从 代码 来 看 ， substituteBindings 用 于 显示 的 参数 转 
化 ，substituteImplicitBindings 用 于 隐 性 的 参数 转化 。 


隐 性 参数 转化 源码 解析 
进行 隐 性 参数 转化 ， 其 步骤 为 : 


e 扫描 控制 器 方法 或 者 闭 包 郊 数 所 有 的 参数 ， 提 取出 数据 库 模型 类 型 对 象 


e 根据 模型 类 型 对 象 的 name ， 找 出 与 模型 对 象 命 名 相同 的 路 由 参数 
e 根据 模型 类 型 对 象 的 _ classname ， 构 建 数据 库 模型 类 型 对 象 ， 根 据 路 由 参数 
的 数值 在 数据 库 中 执行 sql 语句 查 询 


public function substituteImplicitBindings($route) 
{ 

ImplicitRouteBinding: :resolveForRoute($this->container, $rou 
te); 


} 


class ImplicitRouteBinding 


{ 


public static function resolveForRoute($container, $route) 


{ 


$parameters = $route->parameters(); 
foreach ($route->signatureParameters(Model::class) as $p 
arameter) { 


$class = $parameter->getClass(); 


if (array_key_exists($parameter->name, $parameters) 


&& 
! $route->parameter($parameter->name) instanceof 
Model) { 
$method = $parameter ->isDefaultValueAvailable( ) 
2 irs. c ShirSeOrradl* 


$model = $container->make($class->name) ; 


$route->setParameter ( 
$parameter->name, $model->where( 
$model->getRouteKeyName(), $parameters[$ 
parameter ->name ] 
)->{$method}() 
); 


值得 注意 的 是 ， 显 示 参 数 转化 的 优先 级 要 高 于 隐 性 转化 ， 如 果 当 前 参数 已 经 被 
model 郊 数 显示 转化 ， 那 么 该 参数 并 不 会 进行 隐 性 转化 ， 也 就 是 上 面 语句 | 


$route->parameter($parameter->name) instanceof Model 的 作用 。 


其 中 扫描 控制 器 方法 参数 的 功能 主要 利用 反射 机 制 : 


public function signatureParameters($subClass = null) 
{ 

return RouteSignatureParameters::fromAction($this->action, $ 
subClass); 


j 


class RouteSignatureParameters 
t 
public static function fromAction(array $action, $subClass = 
null) 
{ 
$parameters = is_string($action['uses']) 
? static::fromClassMethodString($action[ 
'uses']) 
(new ReflectionFunction(S$action['uses' 
]))->getParameters(); 


return is_null($subClass) ? $parameters : array_filter($ 
parameters, function ($p) use ($subClass) { 
return $p->getClass() && $p->getClass()->isSubclassoO 


f($subClass); 
3); 
} 
protected static function fromClassMethodString($uses) 
{ 
list($class, $method) = Str::parseCallback($uses); 
return (new ReflectionMethod($class, $method) )->getParam 
eters(); 
} 


bind 显示 参数 绑 定 


路 由 的 bind 功能 由 专门 的 binders 数组 负责 ， 这 个 数组 中 保存 着 所 有 的 需要 
显示 转化 的 路 由 参数 与 他 们 的 转化 闭 包 函数 : 


public function bind($key, $binder) 


{ 
$this->binders[str_replace('-', ' ', $key)] = RouteBinding:: 
forcallback( 
$this->container, $binder 
); 
} 
class RouteBinding 
{ 
public static function forCallback($container, $binder) 
f 
if (is string(S$binder)) { 
return static::createClassBinding($container, $binde 
r); 
} 
return $binder; 
} 


protected static function createClassBinding($container, $bi 
nding) 


{ 
return function ($value, $route) use ($container, $bindi 
ng) { 
list($class, $method) - Str::parseCallback($binding, 
doy are e 
$callable = [$container->make($class), $method]; 
return call_user_func($callable, $value, $route); 
}; 
} 
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可 以 看 出 ， bind MATS <A> classname@method ^ classname * 4 
果 仅 仅 绑 定 了 一 个 类 名 ， 那 么 程序 默认 调用 类 中 bind 方法 。 


model 显示 参数 绑 定 
model 调用 bind Až > RA bind 有 子 数 一 个 提前 包装 好 的 闭 包 函数 : 


public function model($key, $class, Closure $callback = null) 


{ 
$this->bind($key, RouteBinding::forModel($this->container, $ 
class, $callback)); 


} 


class RouteBinding 


{ 


public static function forModel($container, $class, $callbac 
k = null) 
t 


return function ($value) use ($container, $class, $callb 
ack) ( 
if (is null($value)) { 
return; 


$instance - $container-»make($class); 
if ($model = $instance->where($instance->getRouteKey 


Name(), $value)->first()) { 
return $model; 


if ($callback instanceof Closure) { 
return call_user_func($callback, $value); 


throw (new ModelNotFoundException) ->setModel($class) 


HH 
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用 路 由 参数 值 来 查询 数据 库 ， 返 回 对 象 。 model 还 可 以 提供 默认 的 闭 包 元 数 ， 以 
供 查 询 不 到 数据 库 时 调用 。 


显示 路 由 参数 转化 


当 运 行 中 间 件 SubstituteBindings 时 ， 就 会 将 先前 绑 定 的 各 个 闭 包 有 函数 执行 ， 
并 对 路 由 参数 进行 转化 : 


public function substituteBindings($route) 


{ 
foreach ($route->parameters() as $key => $value) { 
if (isset($this->binders[$key])) { 
$route->setParameter($key, $this->performBinding($ke 
y, $value, $route)); 


} 


return $route; 


protected function performBinding($key, $value, $route) 


{ 


return call_user_func($this->binders[$key], $value, $route); 


public function setParameter ($name, $value) 


i 


$this->parameters(); 


$this->parameters[$name] = $value; 


经 过 前 面 一 系列 中 间 件 的 工作 ， 现 在 请 求 终于 要 达到 了 正确 的 控制 器 方法 了 。 本 篇 
文章 主要 讲 laravel 如 何 调用 控制 器 方法 ， 并 且 为 控制 器 方法 依赖 注入 构建 参数 
的 过 程 。 


路 由 控制 器 的 调用 


我 们 前 面 已 经 解析 过 中 间 件 的 搜集 与 排序 、pipeline 的 原理 ， 接 下 来 就 要 进行 路 由 
的 run 运行 函数 : 
protected function runRouteWithinStack(Route $route, Request $re 


quest) 
{ 


$shouldSkipMiddleware = $this->container->bound('middleware. 
disable') && 
$this->container ->make( 'middleware.d 


isable') === true; 


$middleware = $shouldSkipMiddleware ? [] : $this->gatherRout 
eMiddleware($route); 


return (new Pipeline($this->container ) ) 

->send($request ) 

->through($middleware ) 

->then(function ($request) use ($route) { 
return $this->prepareResponse( 

$request, $route->run() 

); 

3); 


路 由 的 run 子 数 主要 负责 路 由 控制 器 方法 与 路 由 闭 包 函数 的 运 和 


public function runt) 


{ 
$this->container = $this->container ?: new Container; 
EUW si 
if ($this->isControllerAction()) { 
return $this-»runController(); 
} 
return $this-»runCallable(); 
} catch (HttpResponseException $e) { 
return $e->getResponse(); 
} 
} 


路 由 的 运行 主要 人 靠 ControllerDispatcher 这 个 类 : 


class Route 


{ 
protected function isControllerAction() 
{ 
return is_string($this->action['uses']); 
} 
protected function runController() 
{ 
return (new ControllerDispatcher ($this->container ) )->dis 
patch( 
$this, $this->getController(), $this-»getControllerM 
ethod() 
); 
} 
} 
class ControllerDispatcher 
{ 
use RouteDependencyResolverTrait; 
public function dispatch(Route $route, $controller, $method) 
{ 
$parameters = $this->resolveClassMethodDependencies ( 
$route->parameterswithoutNulls(), $controller, $meth 
od 
); 
if (method exists($controller, 'callAction')) { 
return $controller->callAction($method, $parameters) 
} 
return $controller->{$method}(...array_values($parameter 
S)); 
} 
} 


上 面 可 以 很 清晰 地 看 出 ， 控 制 器 的 运行 分 为 两 


NE 


: 解析 函数 参数、 调用 callAction 


解析 控制 器 方法 参数 


解析 参数 的 功能 主要 由 ControllerDispatcher 类 的 


RouteDependencyResolverTrait 这 一 trait 负责 : 


trait RouteDependencyResolverTrait 


í 


protected function resolveClassMethodDependencies(array $par 
ameters, $instance, $method) 


x 
if (! method exists(S$instance, $method)) { 
return $parameters; 
} 
return $this->resolveMethodDependencies( 
$parameters, new ReflectionMethod($instance, $method 
) 
); 
} 


public function resolveMethodDependencies(array $parameters, 
ReflectionFunctionAbstract $reflector) 


{ 
$instanceCount = 0; 
$values = array_values($parameters); 
foreach ($reflector->getParameters() as $key => $paramet 
er) { 


$instance = $this->transformDependency ( 
$parameter, $parameters 


); 


if (! is_null($instance)) { 
$instanceCount++; 


$this->spliceIntoParameters($parameters, $key, $ 
instance); 
} elseif (! isset($values[$key - $instanceCount]) && 


$parameter ->isDefaultValueAvailable()) { 
$this->spliceIntoParameters($parameters, $key, $ 
parameter ->getDefaultValue()); 


} 


return $parameters; 


控制 器 方法 函数 参数 构造 难点 在 于 ， 参 数 来 源 有 三 种 : 


e 路 由 参数 赋值 
e loc 容器 自动 注入 
e 函数 自 带 默认 值 


在 loc 容器 自动 注入 的 时 候 ， 要 保证 路 由 的 现 有 参数 中 没有 相应 的 类 ， 防 止 依赖 注 
AE BS DEI AE : 


protected function transformDependency(ReflectionParameter $para 
meter, $parameters) 


{ 


$class = $parameter-»getClass(); 


if ($class && ! $this->alreadyInParameters($class->name, $pa 
rameters)) { 
return $this->container->make($class->name); 


protected function alreadyInParameters($class, array $parameters) 


return ! is_null(Arr::first($parameters, function ($value) u 
se ($class) { 
return $value instanceof $class; 


})); 





由 loc 容器 构造 出 的 参数 需要 插入 到 原 有 的 路 由 参数 数组 中 : 


if (! is_null($instance)) { 
$instanceCount++; 


$this->spliceIntoParameters($parameters, $key, $instance); 


protected function spliceIntoParameters(array &$parameters, $off 
set, $value) 


{ 
array_splice( 
$parameters, $offset, 0, [$value] 


); 


当 路 由 的 参数 数组 与 loc 容器 构造 的 参数 数量 不 足以 覆盖 控制 器 参数 个 数 时 ， 就 要 
去 判断 控制 器 是 否 具 有 默认 参数 : 


elseif (! isset($values[$key - $instanceCount]) && 
$parameter ->isDefaultValueAvailable()) { 
$this->spliceIntoParameters($parameters, $key, $parameter->g 
etDefaultValue()); 


} 


调用 控制 器 方法 callAction 


所 有 的 控制 器 并 非 是 直接 调用 相应 方法 的 ， 而 是 通过 callaction 函数 再 分 配 ， 
如 果实 在 没有 相应 方法 还 会 调用 魔术 方法 call(): 


public function callAction($method, $parameters) 


{ 


return call_user_func_array([$this, $method], $parameters); 





public function _ call($method, $parameters) 


{ 
throw new BadMethodCallException("Method [{$method}] does no 


t-exists je 


j 


路 由 闭 包 函数 的 调用 
路 由 闭 包 函 数 的 调用 与 控制 器 方法 一 样 ， 仍 然 需要 依赖 注入 ， 参 数 构造 : 


protected function runCallable() 


{ 

$callable = $this-»action['uses']; 

return $callable(...array_values($this->resolveMethodDepende 
ncies( 


$this->parameterswithoutNulls(), new ReflectionFunction( 
$this->action['uses']) 


))); 


我 们 在 前 面 的 文章 已 经 讲 了 整个 路 由 与 控制 器 的 源码 ， 我 们 今天 这 个 文章 开始 向 大 
家 介绍 在 laravel 中 创建 RESTFul 风格 的 控制 器 。 


关于 什么 是 RESTFul 风 格 及 其 规范 可 参考 这 篇 文章 : 理解 RESTful 架 构 。 


KF laravel 中 RESTFUL 风格 控制 器 的 创建 简要 介绍 : HTTP 控 制 器 实例 教 
程 一 一 创建 RESTFul 风格 控制 器 实现 文章 增删 改 查 


创建 RESTFul 风格 控制 器 
要 想 在 laravel 中 创建 RESTFUL 风格 控制 器 ， 只 需要 一 名 : 


Route::resource('post', 'PostController'); 


该 路 由 包含 了 指向 多 个 动作 的 子路 由 : 


方法 路 径 动作 路 由 名 称 
GET /post index post.index 
GET /post/create create post.create 
POST /post store post.store 
GET /post/{post} show post.show 
GET /post/(posty/edit edit post.edit 
PUT/PATCH /post/{post} update post.update 
DELETE /post/{post} destroy post.destroy 


这 种 用 法 既 简单 又 方便 ， 接 下 来 ， 我 们 将 会 说 一 下 laravel 为 我 们 提供 的 更 加 灵 
活 的 用 法 。 


前 级 RESTFul 路 由 


可 以 为 RESTFUL 路 由 定义 前 级 : 


$router->resource('prefix/foos', 'FooController'); 


$this->assertEquals('prefix/foos/{foo}', $routes[3]->uri()); 


双 参 数 RESTFul 路 由 
laravel 允许 定义 拥有 两 个 参数 的 RESTFul 路 由 : 
$router->resource('foos.bars', 'FooController'); 


$this->assertEquals('foos/{foo}/bars/{bar}', $routes[3]-»uri()); 


参数 自 定 义 命 名 


一 般 来 说 ， RESTFUL 路 由 的 参数 命名 规则 是 路 由 单数 ， 符 号 - HA  ， 例 如 
下 面 例子 中 bars ， 和 foo-baz 。 


$router->resource('foos', 'FooController'); 
$this->assertEquals('foos/{foo}', $routes[3]->uri()); 


$router->resource('foo-bar.foo-baz', 'FooController', ['only' => 

['show']]); 
$this->assertEquals('foo-bar/{foo_bar}/foo-baz/{foo_baz}', $rout 
es[0]-»uri()); 


我 们 可 以 利用 parameters 强制 这 种 单数 模式 : 


$router->resource('foos', 'FooController', ['parameters' => 'sin 
gular']); 
$this->assertEquals('foos/{foo}', $routes[3]->uri()); 


我 们 也 可 以 利用 singularParameters 来 强制 : 


ResourceRegistrar::singularParameters(true); 


$router->resource('foos', 'FooController', ['parameters' => 'sin 


gular']); 
$this->assertEquals('foos/{foo}', $routes[3]->uri()); 


我 们 还 可 以 不 使 用 单数 ， 利 用 parameters 用 自己 自 定 义 的 名 字 来 定义 参数 : 


$router->resource('bars.foos.bazs', 'FooController', ['parameter 
s' => ['foos' => "oof', *bazs' => 'b']]); 


$this->assertEquals( 'bars/{bar}/foos/{oof}/bazs/{b}', $routes[3] 
->uri()); 


同时 ， 我 们 仍然 可 以 利用 setParameters 函数 来 自 定 义 参 数 命名 : 


ResourceRegistrar::setParameters(['foos' => 'oof', 'bazs' => 'b' 


IDE 


$router->resource('bars.foos.bazs', 'FooController'); 
$this->assertEquals('bars/{bar}/foos/{oof}/bazs/{b}', $routes[3] 
->uri()); 


RESTFul 路 由 动词 控制 


laravel 为 RESTFul 路 由 生成 了 两 个 带 有 动词 的 路 由 : create ` 
edit ， 分 别 用 于 加 载 订单 的 创建 页 面 与 编辑 页 面 ， 这 两 个 动词 laravel 是 允 
THERE): 


ResourceRegistrar: :verbs([ 
'create' => 'ajouter', 
'edit' -» 'modifier', 


1); 


$router->resource('foo', 'FooController'); 
$routes = $router-»getRoutes(); 


$this->assertEquals('foo/ajouter', $routes->getByName('foo.creat 
e')->uri()); 

$this->assertEquals('foo/{foo}/modifier', $routes->getByName('fo 
o.edit')->uri()); 


控制 器 方法 约束 


一 般 情 况 下 ， 我 们 都 会 一 次 性 想 要 上 面 所 生成 的 七 个 路 由 ， 然 而 ， 有 时 候 ， 我 们 只 
需要 其 中 几 个 ， 或 者 不 想 要 其 中 几 个 。 这 时 候 就 可 以 利用 only 或 者 except : 


$router = $this->getRouter(); 

$router->resource('foo', 'FooController', ['only' => ['show', 'd 
estroy']]); 

$routes = $router->getRoutes(); 


$this->assertCount(2, $routes); 

$router = $this->getRouter(); 

$router->resource('foo', 'FooController', ['except' => ['show', 
'destroy']]); 


$routes - $router-»getRoutes(); 


$this->assertCount(5, $routes); 


RESTFul 路 由 名 称 自 定 义 


RESTFul 路 由 的 每 个 路 由 都 要 自己 默认 的 路 由 名 称 ， laravel 允许 我 们 对 路 由 
名 称 进行 修改 : 


我 们 可 以 用 as 来 为 路 由 名 称 添加 前 级 : 


$router->resource('foo-bars', 'FooController', ['only' => ['show' 
], 'as' => 'prefix']); 


$this-»assertEquals('prefix.foo-bars.show', $routes[0]-»getName( 


2): 
| See) Kj 


当 有 多 个 路 由 参数 的 时 候 ， 路 由 参数 默认 添加 到 了 路 由 名 称 中 : 
$router->resource('prefix/foo.bar', 'FooController'); 


$this->assertTrue($router ->getRoutes( )->hasNamedRoute('foo.bar.i 
ndex')); 


可 以 利用 names 为 单个 路 由 来 命名 : 


$router->resource('foo', 'FooController', ['names' => [ 
"index' => 'foo', 
'show' => 'bar', 


11); 


$this-»assertTrue($router-»getRoutes( ) -»hasNamedRoute( ' foo' )); 
$this-»assertTrue($router-»getRoutes( )-»hasNamedRoute( 'bar ' )); 


还 可 以 利用 names 为 所 有 路 由 来 命名 : 


$router->resource('foo', 'FooController', ['names' => 'bar']); 


$this->assertTrue($router ->getRoutes( )->hasNamedRoute( 'bar.index' 


2): 
| mS SM Sl 





RESTFul 路 由 源码 分 析 


RESTFul 路 由 的 创建 工作 由 类 ResourceRegistrar 负责 ， 这 个 类 为 默认 为 用 
户 创建 七 个 路 由 ， 函 数 方法 register 是 创建 路 由 的 主 函 数 : 


class ResourceRegistrar 


{ 


public function register($name, $controller, array $options 
zi 
{ 
if (isset($options['parameters']) && ! isset($this->para 
meters)) { 
$this->parameters = $options['parameters']; 


if (Str::contains($name, '/')) { 
$this->prefixedResource($name, $controller, $options 


return; 


$base = $this->getResourcewildcard(last(explode('.', $na 
me))); 


$defaults = $this->resourceDefaults; 


foreach ($this->getResourceMethods($defaults, $options) 
as $m) { 
$this->{'addResource'.ucfirst($m)}($name, $base, $co 
ntroller, $options); 


} 


Ww 


这 个 函数 主要 流程 分 为 三 段 : 


e 判断 是 否 由 前 组 
e 获取 路 由 的 基础 参数 


e 添加 路 由 


拥有 前 组 的 RESTFul 路 由 


如 果 我 们 为 RESTFUL 路 由 添加 了 前 级 ， 那 么 laravel 将 会 以 group 的 形式 
添加 路 由 : 


protected function prefixedResource($name, $controller, array $0 
ptions) 


{ 
list($name, $prefix) = $this->getResourcePrefix($name) ; 
$callback = function ($me) use ($name, $controller, $options) 
{ 
$me->resource($name, $controller, $options); 
}; 
return $this->router->group(compact('prefix'), $callback); 
} 
protected function getResourcePrefix( $name) 
{ 
$segments = explode('/', $name); 
$prefix = implode('/', array_slice($segments, 0, -1)); 
return [end($segments), $prefix]; 
} 


[| 


获取 基础 RESTFUL 路 由 参数 


在 添加 各 种 路 由 之 前 ， 我 们 需要 先 获 取 路 由 的 基础 参数 ， 也 就 是 当 存 在 多 参数 情况 
下 ， 最 后 的 参数 。 获 取 参 数 后 ， 如 果 用 户 有 自 定 义 命 名 ， 则 获取 自 定义 命名 : 


public function getResourceWildcard($value) 
1 
if (isset($this->parameters[$value])) 1 
$value = $this->parameters[$value]; 
} elseif (isset(static::$parameterMap[$value])) { 
$value = static::$parameterMap[$value] ; 
} elseif ($this->parameters === 'singular' || static 
larParameters) { 
$value = Str::singular ($value); 


return str replace('-', ' ', $value); 


添加 各 种 路 由 


添加 路 由 主要 有 三 个 步骤 : 


e 计算 路 由 uri 
e 获取 路 由 属性 
e 创建 路 由 


::$singu 


protected function addResourceIndex($name, $base, $controller, $ 


options) 
{ 


$uri = $this->getResourceUri($name); 


$action = $this->getResourceAction($name, $controller, ‘inde 


x', $options); 


return $this->router->get($uri, $action); 


SU Hh uri 时 ， 由 于 存在 多 参数 的 情况 ， 需 要 循环 计算 路 由 参数 


. 
. 


public function getResourceUri($resource) 
{ 
if (! Str::contains($resource, '.')) { 
return $resource; 


$segments = explode('.', $resource); 
$uri = $this->getNestedResourceUri($segments) ; 


return str_replace('/{'.$this->getResourcewildcard(end($segm 
Ones) je)", Su) 
} 


protected function getNestedResourceUri(array $segments) 


{ 
return implode('/', array map(function ($s) { 
return $s.'/{'.$this->getResourcewildcard($s).'}'; 
), $segments)); 


当 计 算 路 由 的 属性 时 ， 最 重要 的 是 获取 路 由 的 名 字 ， 路 由 的 名 字 可 以 是 默认 ， 也 可 
以 是 用 户 利用 names 或 者 as 属性 来 自 定 义 : 


protected function getResourceAction($resource, $controller, $me 
thod, $options) 


{ 

$name = $this->getResourceRouteName($resource, $method, $opt 
ions); 

$action = ['as' => $name, 'uses' => $controller.'@'.$method ] 

if (isset($options['middleware'])) { 

$action[ 'middleware'] = $options['middleware']; 

J 

return $action; 
E 
protected function getResourceRouteName($resource, $method, $opt 
ions) 
{ 


$name = $resource; 


if (isset($options['names'])) { 
if (is_string($options['names'])) { 
$name = $options['names']; 
} elseif (isset($options['names'][$method])) { 
return $options[ 'names'][$method]; 


$prefix = isset($options['as']) ? $options['as'].'.' : p 


return trim(sprintf('%s%s.%s', $prefix, $name, $method), '.' 


值得 注意 的 是 ， 如 果 单 独 为 某 一 个 方法 命名 ， 那 么 直接 回 返回 命名 ， 而 不 会 受 
as 和 方法 名 'method' 的 影响 。 


Laravel HTTP—— RESTFul 风格 路 由 的 使 用 与 源码 分 析 
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laravel 为 我 们 提供 便携 的 重 定向 功能 ， 可 以 由 门面 Redirect ， 或 者 全 局 函 
数 redirect() 来 启用 ， 本 篇 文章 将 会 介绍 重 定向 功能 的 具体 细节 及 源码 分 析 。 


URI 重 定 向 


功能 是 由 类 UrlGenerator 所 实现 ， 这 个 类 需要 request 来 进 和 


初始 


kp 
n 
I 


$url = new UrlGenerator( 
$routes = new RouteCollection, 
$request = Request::create('http://www.foo.com/') 


)) 
重 定 向 到 uri 
e 当 我 们 想 要 重 定向 到 某 个 地 址 时 ， 可 以 使 用 to BK: 


$this->assertEquals('http://www.foo.com/foo/bar', $url->to('foo/ 
bar')); 


e 当 我 们 想 要 添加 额外 的 路 径 ， 可 以 将 数组 赋 给 第 二 个 参数 : 
$this->assertEquals('https://www.foo.com/foo/bar/baz/boom', $url 
-»to('foo/bar', ['baz', 'boom'], true)); 


$this->assertEquals( 'https://ww.foo.com/foo/bar/baz?foo=bar', $ 
url->to('foo/bar?foo=bar', ['baz'], true)); 


强制 https 


如 果 我 们 想 要 重 定向 到 https ， 我 们 可 以 设置 第 


IT 
> 
XW 
D 


$this->assertEquals( 'https://ww.foo.com/foo/bar', $url->to('foo 
(bar; 1. true) 


或 者 使 用 forcescheme WA: 


$url->forceScheme('https'); 


$this->assertEquals( 'https://ww.foo.com/foo/bar', $url->to('foo 
/bar ' ); 


强制 域名 


$url->forceRootUrl('https://www.bar.com'); 


$this-»-assertEquals('https://www.bar.com/foo/bar', $url->to('foo 
/bar'); 


$url->formatPathUsing(function ($path) { 
return '/something'.$path; 


3); 


$this-»assertEquals('http://www.foo.com/something/foo/bar', $url 
-»to('foo/bar')); 


路 由 重 定向 


重 定 向 另 一 个 非常 重要 的 功能 是 重 定向 到 路 由 所 在 的 地 址 中 去 : 


$route = new Route(['GET'], '/named-route', ['as' => 'plain']); 
$routes->add($route) ; 


$this->assertEquals( 'http:/www.bar.com/named-route', $url->route( 
"parnm 
id OO || 














非 域名 路 径 
laravel 路 由 重 定 向 可 以 选择 重 定 向 后 的 地 址 是 否 仍然 带 有 域名 ， 这 个 特性 由 第 


三 个 参数 决定 : 


$route = new Route(['GET'], '/named-route', ['as' => 'plain']); 
$routes->add($route) ; 


$this->assertEquals('/named-route', $url->route('plain', [], fal 


Se 中 


重 定向 端口 号 
路 由 重 定向 可 以 允许 带 有 request 自己 的 端口 : 


$url = new UrlGenerator( 
$routes = new RouteCollection, 
$request = Request::create('http://www.foo.com:8080/' ) 


); 


$route = new Route(['GET'], 'foo/bar/{baz}', ['as' => 'bar', 'do 
main' => 'sub.{foo}.com']); 
$routes-»add($route); 


$this-»assertEquals('http://sub.taylor.com:8080/foo/bar/otwell', 
$url->route('bar', ['taylor', 'otwell'])); 


$E RAS AREE 


如 果 路 由 中 含有 参数 ， 可 以 将 需要 的 参数 赋 给 route 第 二 个 参数 : 


$route = new Route(['GET'], 'foo/bar/{baz}', ['as' => 'foobar']) 


$routes->add($route); 


$this->assertEquals( 'http://www.foo.com/foo/bar/taylor', $url->r 
oute('foobar', 'taylor')); 


也 可 以 根据 参数 的 命名 来 指定 参数 绑 定 : 


$route = new Route(['GET'], 'foo/bar/{baz}/breeze/{boom}', ['as' 
=> 'bar']); 


$routes->add($route); 


$this->assertEquals( 'http://www. foo.com/foo/bar/otwell/breeze/ta 
ylor', $url->route('bar', ['boom' => 'taylor', 'baz' => 'otwell' 


])); 
还 可 以 利用 defaults BRA EE je ERU S] A CREE : 


$url->defaults(['locale' => 'en']); 
$route = new Route(['GET'], 'foo', ['as' => 'defaults', 'domain' 
=> '{locale}.example.com', function () { 


31); 


$routes->add($route); 


$this->assertEquals('http://en.example.com/foo', $url->route('de 
faults')); 


重 定向 路 由 querystring 添加 


SH route 函数 中 赋 给 的 参数 多 于 路 径 参 数 的 时 候 ， 多 余 的 参数 会 被 添加 到 
querystring 中 : 


$route = new Route(['GET'], 'foo/bar/{baz}/breeze/{boom}', ['as' 
=> 'bar']); 


$routes->add($route); 


$this->assertEquals( 'http://www. foo.com/foo/bar/taylor/breeze/ot 
well?fly=wall', $url->route('bar', ['taylor', 'otwell', 'fly' => 
'wall'])); 


a —— s ÁÀÁ 
fragment 重 定向 


$route = new Route(['GET'], 'foo/bar#derp', ['as' => 'fragment' ] 
); 


$routes->add($route); 


$this->assertEquals('/foo/bar?baz=%C3%A5%CE%B1%D1%84#derp', $url 
-»route('fragment', ['baz' => 'aagd'], false)); 


路 由 action 重 定向 
我 们 不 仅 可 以 通过 路 由 的 别名 来 重 定向 ， 还 可 以 利用 路 由 的 控制 器 方法 来 重 定向 : 


$route = new Route(['GET'], 'foo/bam', ['controller' => 'foo@bar' 


1); 


$routes->add($route); 


$this->assertEquals( 'http://www.foo.com/foo/bam', $url->action(' 
foo@bar')); 


4 ——— 0] 


可 以 设 定 重 定向 控制 器 的 默认 命名 空间 : 


$url->setRootControllerNamespace('namespace'); 


$route = new Route(['GET'], 'foo/bar', ['controller' => 'namespa 


ce\foo@bar']); 
$routes->add($route); 


$route = new Route(['GET'], 'something/else', ['controller' => ' 


something\foo@bar']); 
$routes->add($route) ; 


$this->assertEquals( 'http://www.foo.com/foo/bar', $url-»action(' 


foo@bar')); 


$this->assertEquals( 'http://www.foo.com/something/else', 


ction('\something\foo@bar')); 


UrlRoutable 参数 绑 定 


可 以 为 重 定向 传 入 UrlRoutable 类 型 es 参数 ， 重 定向 会 通过 类 方法 
getRouteKey 来 获取 对 象 的 某 个 属性 ， bie 路 由 的 参数 中 去 。 


$url->a 


public function testRoutableInterfaceRoutingwithSingleParameter () 


$url = new UrlGenerator( 
$routes = new RouteCollection, 
$request = Request::create('http://www.foo.com/' ) 


); 


$route = new Route(['GET'], 'foo/{bar}', ['as' => 'routable' 


1); 


$routes->add($route); 


$model = new RoutableInterfaceStub; 
$model->key = 'routable'; 


$this->assertEquals('/foo/routable', $url->route('routable', 
$model, false)); 


j 
class RoutableInterfaceStub implements UrlRoutable 
{ 

public $key; 


public function getRouteKey() 


{ 
return $this->{$this->getRouteKeyName()}; 
} 
public function getRouteKeyName( ) 
{ 
return 'key'; 
} 


| 


URI 重 定向 源码 分 析 


在 说 重 定向 的 源码 之 前 ， 我 们 先 了 解 一 下 一 般 的 uri 基本 组 成 : 


scheme: //domain: port/path?queryString 
也 就 是 说 ， 一 般 uri 由 五 部 分 构成 。 重 定向 实际 上 就 是 按照 各 种 传 入 的 参数 以 及 
属性 的 设置 来 重新 生成 上 面 的 五 部 分 : 


public function to($path, $extra = [], $secure = null) 


{ 
if ($this->isValidUrl($path)) { 
return $path; 


$tail = implode('/', array map( 

'rawurlencode', (array) $this->formatParameters($extra) ) 
); 
$root = $this->formatRoot($this->formatScheme($secure) ); 
list($path, $query) = $this->extractQueryString($path); 
return $this->format( 


Sroot, '/'.trim($path.'/'.$tail, '/') 
). $query; 


重 定 向 scheme 


重 定向 的 scheme WSF formatScheme 生成 : 


public function formatScheme($secure) 
{ 
if (! is_null($secure)) { 
return $secure ? 'https://' : "http:77 


if (is null($this-»cachedSchema)) { 
$this->cachedSchema = $this->forceScheme ?: $this->reque 
st->getScheme().'://'; 


} 
return $this->cachedSchema; 
} 
public function forceScheme($schema) 
{ 
$this->cachedSchema = null; 
$this->forceScheme = $schema.'://'; 
} 


可 以 看 出 来 ， scheme 的 生成 存在 优先 级 : 


e 由 to 传 入 的 secure 参数 
e 由 forceScheme 设置 的 schema 参数 


e request 4 #49 scheme 


重 定 向 domain 


重 定向 的 domain WHA formatRoot 生成 : 


public function formatRoot($scheme, $root = null) 
{ 
if (is_null($root)) { 
if (is_null($this->cachedRoot)) { 
$this->cachedRoot = $this->forcedRoot ?: $this->requ 
est->root(); 


} 
$root = $this-»cachedRoot; 
J 
$start = Str::startswith($root, 'http://') 2 'http://' : “ht 
CDSE ue 
return preg_replace('~'.$start.'~', $scheme, $root, 1); 
} 
public function forceRootUrl($root) 
{ 
$this->forcedRoot = rtrim($root, '/'); 
$this->cachedRoot = null; 
} 


与 scheme 类 似 ， root 的 生成 也 存在 优先 级 : 


e 由 to 传 入 的 root 参数 
e 由 forceRootUrl 设置 的 root 参数 
e request 4 9) root 


重 定 向 path 


重 定向 的 path 由 三 部 分 构成 ， 一 部 分 是 request 自 带 的 path ， 一 部 分 是 
函数 to RAH path ， 另 一 部 分 是 函数 to 传 入 的 参数 : 


public function formatParameters($parameters ) 


1 
$parameters = array wrap($parameters); 
foreach ($parameters as $key => $parameter) ( 
if ($parameter instanceof UrlRoutable) { 
$parameters[$key] = $parameter-»getRouteKey(); 
} 
} 
return $parameters; 
} 
protected function extractQueryString($path) 
1 
if (($queryPosition = strpos($path, '?')) !== false) { 
return [ 
substr($path, 0, $queryPosition), 
substr($path, $queryPosition), 
l; 
J 
return [$path, '"']; 
} 


路 由 重 定 向 源码 分 析 


相对 于 uri 的 重 定向 来 说 ， 路 由 重 定向 的 scheme ^ root 
、path ^ queryString 都 要 以 路 由 自身 的 属性 为 第 一 优先 级 ， 此 外 还 要 利用 
额外 参数 来 绑 定 路 由 的 uri FR: 


public function route($name, $parameters = [], $absolute = true) 


if (! is_null($route = $this->routes->getByName($name))) { 
return $this->toRoute($route, $parameters, $absolute); 


throw new InvalidArgumentException("Route [{$name}] not defi 
ned.™); 


} 


public function to($route, $parameters = [], $absolute = false) 


{ 


$domain = $this->getRouteDomain($route, $parameters); 


$uri = $this->addQueryString($this->url->format ( 
$root = $this->replaceRootParameters($route, $domain, $p 


arameters), 
$this->replaceRouteParameters($route->uri(), $parameters 
) 
), $parameters); 
if (preg_match('/\{.*?\}/', $uri)) ( 
throw UrlGenerationException::forMissingParameters($rout 
e); 
J 
$uri = strtr(rawurlencode($uri), $this->dontEncode) ; 
if (! $absolute) { 
return '/'.ltrim(str replace($root, '', $uri), '/'); 
} 
return $uri; 
} 


al ee «| 


路 由 重 定 向 scheme 


路 由 的 重 定 向 scheme 需要 先 判断 路 由 的 scheme 属性 : 


protected function getRouteScheme($route) 


{ 
if ($route->httpOnly()) { 
return 'http://'; 
} elseif ($route->httpsOnly()) { 
return “htetps.377 ©; 
} else { 
return $this->url->formatScheme(null); 
} 
} 


路 由 重 定 向 domain 


public function to($route, $parameters = [], $absolute = false) 


{ 


$domain = $this->getRouteDomain($route, $parameters); 


$uri = $this->addQueryString($this->url->format ( 
$root = $this->replaceRootParameters($route, $domain, $p 
arameters), 
$this->replaceRouteParameters($route->uri(), $parameters 


), $parameters); 


protected function getRouteDomain($route, &$parameters) 


{ 
return $route->domain() ? $this->formatDomain($route, $param 
eters) : null; 


} 


protected function formatDomain($route, &$parameters) 


{ 


return $this->addPortToDomain( 


$this->getRouteScheme($route) .$route->domain( ) 


): 


protected function addPortToDomain( $domain) 


1 
$secure = $this-»request-»isSecure(); 
$port = (int) $this->request->getPort(); 
return ($secure && $port === 443) || (! $secure && $port === 
80) 
? $domain : $domain.':'.$port; 
} 


protected function replaceRootParameters($route, $domain, &$para 
meters) 


{ 


$scheme = $this->getRouteScheme($route) ; 


return $this->replaceRouteParameters( 
$this->url->formatRoot($scheme, $domain), $parameters 
); 
} 


SS 
可 以 看 出 路 由 重 定向 时 ， 域 名 的 生成 主要 先 经 过 函数 getRouteDomain ,判断 路 由 


是 否 有 domain 属性 ,如 果 有 域名 属性 ， 则 将 会 作为 ”formatRoot 函数 的 参数 传 
入 ， 和 否则 就 会 默认 居 动 1 uri 重 定向 的 域名 生成 方法 。 


路 由 重 定 向 参数 绑 定 


路 由 重 定向 可 以 利用 函数 replaceRootParameters 在 域名 当中 参数 绑 定 ，， 也 
可 以 在 路 径 当 中 利用 有 函数 replaceRouteParameters HAARE ° HARET 
为 命名 参数 绑 定 与 匿名 参数 绑 定 : 


protected function replaceRouteParameters($path, array &$paramet 
ers) 
{ 


$path = $this->replaceNamedParameters($path, $parameters); 


$path = preg_replace_callback('/\{.*?\}/', function ($match) 
use (&$parameters) { 
return (empty($parameters) && ! Str::endswith($match[0], 
DD 
? $match[6] 
: array shift(S$parameters); 
j, $path); 


return trim(preg_replace('/\{.*?\?\}/', '', $path), '/'); 
} 


E E S) i6 


对 于 命名 参数 绑 定 ,程序 会 分 别 从 变量 列表 、 默 认 变量 列表 中 获取 并 替换 路 由 参数 对 
应 的 数值 ， 若 不 存在 该 参数 ， 则 直接 返回 


protected function replaceNamedParameters($path, &$parameters) 
{ 
return preg_replace_callback('/\{(.*?)\??\}/', function ($m) 
use (&$parameters) { 
if (isset($parameters[$m[1]])) { 
return Arr::pull($parameters, $m[1]); 
} elseif (isset($this->defaultParameters[$m[1]])) { 
return $this->defaultParameters[$m[1]]; 
) else { 
return $m[0]; 
} 
}, $path); 


命名 参数 绑 定 结束 后 ， 剩 下 的 未 被 替换 的 路 由 参数 将 会 被 未 命名 的 变量 按 顺 序 来 痊 
换 。 


路 由 重 定 向 queryString 


如 果 变 量 列表 在 绑 定 路 由 后 仍然 有 剩余 ， 那 么 变量 将 会 作为 路 由 的 
queryString 


protected function addQueryString($uri, array $parameters) 


{ 
if (! is_null($fragment = parse_url($uri, PHP URL FRAGMENT)) 


DE 


$uri = preg replace('/£.*/', '', $uri); 


$uri .= $this-»getRouteQueryString($parameters); 


return is null($fragment) ? $uri : $uri."#{$fragment}"; 


protected function getRouteQueryString(array $parameters) 


{ 
if (count($parameters) == 0) { 
return 22: 


$query = http build query( 
$keyed = $this->getStringParameters($parameters) 


); 


if (count($keyed) < count($parameters)) { 
$query .- '&'.implode( 
'&', $this->getNumericParameters($parameters) 


); 


return '?'.trim($query, '&'); 


路 由 重 足 向 结束 


路 由 uri 构建 完成 后 ， 将 会 继续 判断 是 否 存在 违背 绑 定 的 路 由 参数 ， 是 否 显示 
absolute 的 路 由 地 址 


public function to($route, $parameters = [], $absolute = false) 


{ 
if (preg_match('/\{.*?\}/', $uri)) ( 
throw UrlGenerationException: : forMissingParameters($rout 
e); 
$uri = strtr(rawurlencode($uri), $this-»-dontEncode); 
if (! $absolute) { 


return '/'.ltrim(str replace($root, '', $uri), '/'); 


return $uri; 


laravel 在 启动 时 ， 会 加 载 项 目的 env 文件 ， 本 文 将 会 详细 介绍 env 文件 
的 使 用 与 源码 的 分 析 。 


ENV 文件 的 使 用 


多 环境 ENV 文件 的 设置 
一 、 在 项 目 写 多 个 ENV 文件 ， 例 如 三 个 env 文件 : 


e .env.development ^ 
e .env.staging ^ 


e .env.production ， 
这 三 个 文件 中 分 别针 对 不 同 环境 为 某 些 变量 配置 了 不 同 的 值 ， 
二 、 配 置 APP_ENV 环境 变量 值 
配置 环境 变量 的 方法 有 很 多 ， 其 中 一 个 方法 是 在 nginx 的 配置 文件 中 写 下 这 句 代 


码 : 
fastcgi param APP_ENV production; 
那么 laravel 会 通过 env('APP ENV') 根据 环境 变量 APP ENV 来 判断 当前 


具体 的 环境 ， 假 如 环境 变量 APP_ENV 为 production ， 那 么 laravel 将 会 自 
动 加 载 .env.production 文件 。 


Ae 3. ENV 文件 的 路 径 与 文件 名 
laravel 为 用 户 提供 了 自 定义 ENV 文件 路 径 或 文件 名 的 函数 ， 


例如 ， 若 想 要 自 定义 env 路 径 ， 就 可 以 在 bootstrap 文件 夹 中 app.php X 
件 : 


$app = new Illuminate\Foundation\Application( 
realpath(__DIR_.'/../') 
); 


$app->useEnvironmentPath('/customer/path' ) 


若 想 要 自 定 义 env 文件 名 称 ， 就 可 以 在 bootstrap 文件 夹 中 app.php X 
件 : 


$app = new Illuminate\Foundation\Application( 
realpath(__DIR_.'/../') 
); 


$app->LoadEnvironmentFrom( customer.env') 
ENV 文件 变量 设置 
e 在 env 文件 中 ， 我 们 可 以 为 变量 赋予 具体 值 : 
CFOO=bar 
值得 注意 的 是 ， 这 种 具体 值 不 允许 赋 子 多 个 ， 例 如 : 
CFOO=bar baz 


e 可 以 为 变量 赋予 字符 串 引 用 


CQUOTES="a value with a # character" 


这 种 引用 不 允许 字符 串 中 存在 符号 N ， 只 能 使 用 转 义 字符 NN 


E 
>~ 

ul 
ny 
il 
I 
«x 
hs 
x 


MAAR AT ARS "" ， 只 能 使 用 转移 字符 \" ,否则 取 值 会 意外 结 


CQUOTESWITHQUOTE="a value with a # character & a quote \" charac 
ter inside quotes" # " this is a comment 


$this->assertEquals('a value with a # character & a quote " char 
acter inside quotes', getenv('CQUOTESWITHQUOTE')); 


e 可 以 在 env 文件 中 添加 注释 ， 方 法 是 以 # 开始 : 


CQUOTES="a value with a # character" # this is a comment 


e 可 以 使 用 export 来 为 变量 赋值 : 


export EFOO="bar" 


e 可 以 在 env 文件 中 使 用 变量 为 变量 赋值 : 


NVAR1="Hello" 
NVAR2="World!" 
NVAR3="{$NVAR1} {$NVAR2}" 
NVAR4="${NVAR1} ${NVAR2}" 
NVAR5="$NVAR1 {NVAR2}" 


$this->assertEquals('{$NVAR1} {$NVAR2}', $ ENV['NVAR3']); // not 
resolved 

$this->assertEquals('Hello World!', $ ENV['NVAR4']); 

$this->assertEquals('$NVAR1 {NVAR2}', $ ENV['NVAR5']); // not re 
solved 


ENV 加 载 源 码 分 析 


laravel 加 载 ENV 


ENV 的 加 载 功 能 由 类 
NIlluminateNFoundationNBootstrapNLoadEnvironmentVariables::class 
完成 ， 它 的 启动 函数 为 : 


public function bootstrap(Application $app) 


1 
if ($app-»configurationIsCached()) { 
return; 


$this->checkForSpecificEnvironmentFile($app); 


try { 
(new Dotenv($app->environmentPath(), $app-»-environmentFi 
le()))->load(); 
} catch (InvalidPathException $e) { 
M 


如 果 我 们 在 环境 变量 中 设置 了 APP ENV 变量 ， 那 么 就 会 调用 有 函数 
checkForSpecificEnvironmentFile 来 根据 环境 加 载 不 同 的 env 文件 : 


protected function checkForSpecificEnvironmentFile($app) 
{ 
if (php sapi name() == 'cli' && with($input = new ArgvInput ) 
->hasParameterOption('--env')) { 
$this->setEnvironmentFilePath( 
$app, $app->environmentFile().'.'.$input->getParamet 
erOption('--env' ) 


): 


if (! env('APP ENV')) { 
return; 


$this->setEnvironmentFilePath( 
$app, $app->environmentFile().'.'.env('APP_ENV') 
); 


protected function setEnvironmentFilePath($app, $file) 


{ 
if (file_exists($app->environmentPath().'/'.$file)) { 
$app->loadEnvironmentFrom($file); 


viucas/phpdotenv 源码 解读 


laravel 中 对 env 文件 的 读 取 是 采用 vlucas/phpdotenv 的 开源 项 目 : 


class Dotenv 


{ 
public function __construct($path, $file = '.env') 
{ 
$this->filePath = $this->getFilePath($path, $file); 
$this->loader = new Loader($this->filePath, true); 
} 
public function load() 
{ 
return $this->loadData(); 
} 
protected function loadData($overload = false) 
{ 
$this->loader = new Loader($this->filePath, !$overload); 
return $this->loader->load(); 
} 
} 


env 文件 变量 的 读 取 依赖 类 /Dotenv/Loader : 


class Loader 

{ 
public function load() 
{ 


$this->ensureFileIsReadable(); 


$filePath = $this->filePath; 
$lines = $this->readLinesFromFile($filePath) ; 
foreach ($lines as $line) { 
if (!$this->isComment($line) && $this->looksLikeSett 
er($line)) { 
$this->setEnvironmentVariable($line); 


return $lines; 


我 们 可 以 看 到 ， env 文件 的 读 取 的 流程 : 


e 判断 env x fX 

e 读 取 整个 env 文件 ， 并 将 文件 按 行 存储 
e 循环 读 取 每 一 行 ， 略 过 注释 

e 进行 环境 变量 赋值 


环 


protected function ensureFileIsReadable() 
{ 
if (!is_readable($this->filePath) || !is_file($this->filePat 
h)) t 
throw new InvalidPathException(sprintf('Unable to read t 
he environment file at %s.', $this->filePath)); 


j 


protected function readLinesFromFile($filePath) 
{ 

// Read file into an array of lines with auto-detected line 
endings 

$autodetect = ini get('auto detect line endings'); 

ini set('auto detect line endings', '1'); 

$lines = file($filePath, FILE IGNORE NEW LINES | FILE SKIP E 
MPTY LINES); 

ini set('auto detect line endings', $autodetect); 


return $lines; 


} 
protected function isComment ($line) 
{ 
return strpos(ltrim($line), '#') === 0; 
j 
protected function looksLikeSetter($line) 
{ 
return strpos($line, '-') !== false; 
} 
境 变 量 赋值 是 env 文件 加 载 的 核心 ， 主 要 由 setEnvironmentVariable % 


A : 


public function setEnvironmentVariable($name, $value = null) 


{ 


list($name, $value) = $this->normaliseEnvironmentVariable($n 
ame, $value); 


if ($this->immutable && $this->getEnvironmentVariable( $name ) 
I-- null) ( 
return; 


if (function_exists('apache_getenv') && function_exists('apa 
che_setenv') && apache_getenv($name)) { 
apache_setenv($name, $value); 


if (function_exists('putenv')) { 
putenv("$name-$value"); 


$ ENV[$name] - $value; 


$ SERVER[$name] = $value; 


normaliseEnvironmentVariable HAM 4m £& AAA HARES: 


protected function normaliseEnvironmentVariable($name, $value) 


( 


list($name, $value) $this->splitCompoundStringIntoParts($n 
ame, $value); 

list($name, $value) = $this->sanitiseVariableName($name, $va 
lue); 

list($name, $value) = $this->sanitiseVariableValue($name, $v 


alue); 


$value = $this->resolveNestedVariables($value); 


return array($name, $value); 


splitCompoundStringIntoParts 用 于 将 赋值 语句 转化 为 环境 变量 名 name 和 
环境 变量 值 value 。 


protected function splitCompoundStringIntoParts($name, $value) 


t 
if (strpos($name, '-') !== false) { 
list($name, $value) = array map('trim', explode('-', $na 
me, 2)); 
J 


return array($name, $value); 


sanitiseVariableName 用 于 格式 化 环境 变量 名 : 


protected function sanitiseVariableName($name, $value) 
{ 
$name = trim(str replace(array('export ', 'N'', '"'), '', $n 
ame)); 


return array($name, $value); 


sanitiseVariableValue 用 于 格式 化 环境 变量 值 : 


protected function sanitiseVariableValue($name, $value) 
{ 
$value = trim($value); 
if (!$value) { 
return array($name, $value); 


if ($this->beginswithAQuote($value)) { // value starts with 
a quote 
$quote = $value[0]; 
$regexPattern = sprintf( 
1 /和 
%1$S # match a quote at the start of the va 


( # capturing sub-pattern used 
(25 4 we do not need to capture this 
[^9931$SNNNN] £ any character other than a quote or 
backslash 
[NNNNNNNN £Z or two backslashes together 
| \\\\%1L$S # or an escaped quote e.g \" 


) isi # as many characters that match the pr 

evious rules 

) # end of the capturing sub-pattern 

%1$s # and the closing quote 

a SS # and discard any string after the clo 
sing quote 

ma 

$quote 


); 


$value = preg_replace($regexPattern, '$1', $value); 


$value = str_replace("\\$quote", $quote, $value); 
$value = str_replace('\\\\', '\\', $value); 
} else { 


$parts = explode(' #', $value, 2); 
trim($parts[0]); 


$value 


// Unquoted values cannot contain whitespace 
if (preg_match('/\s+/', $value) > 0) { 
throw new InvalidFileException('Dotenv values contai 
ning spaces must be surrounded by quotes.'); 


j 


return array($name, trim($value) ); 


这 段 代码 是 加 载 env 文件 最 复杂 的 部 分 ， 我 们 详细 来 说 : 


e 若 环境 变量 值 是 具体 值 ， 那 么 仅仅 需要 分 割 注释 s 部 分 ， 并 判断 是 否 存在 空 
格 符 即 可 。 


e 若 环境 变量 值 由 引用 构成 ， 那 么 就 需要 进行 正则 匹配 ， 具 体 的 正则 表达 式 为 : 


/A (22 [N'NN] [NNNN [NN) )" . *S/mx 


这 个 正则 表达 式 的 意思 是 : 


e 提取 7" 双 引 号 内 部 的 字符 囊 ， 抛 弃 双 引号 之 后 的 字符 串 

。 若 双 引 号 内 部 还 有 双 引 号 ， 那 么 以 最 前 面 的 双 引 号 为 提取 内 容 ， 例 如 
"dfd("dfd")fdf"， 我 们 只 能 提取 出 来 最 前 面 的 部 分 "dfd(" 

e STARA ATMA NU ， 例 如 "dfd\"dfd\"fdf", 我 们 就 可 以 提取 出 来 
"dfd\"dfd\"fdf" 。 

e 不 允许 引用 中 含有 \、， 但 可 以 使 用 转 义 字符 NN 


Al & 
本 文 主要 介绍 laravel wR config 配置 文件 的 相关 源码 。 
config 配置 文件 的 加 载 


config 配置 文件 由 类 
\Illuminate\Foundation\Bootstrap\Loadconfiguration::class 完成 : 


class LoadConfiguration 


{ 
public function bootstrap(Application $app) 
{ 
$items = []; 
if (file exists($cached = $app->getCachedConfigPatnh()) ) 
{ 


$items = require $cached; 


$loadedFromCache = true; 


$app->instance('config', $config = new Repository($items 


if (! isset($loadedFromCache)) { 
$this->loadConfigurationFiles($app, $config); 


$app->detectEnvironment(function () use ($config) { 
return $config->get('app.env', 'production'); 


3): 


date default timezone set($config-»get('app.timezone', ' 
Unc» 


mb internal encoding( UTF-8'); 


可 以 看 到 ， 配 置 文件 的 加 载 步 又 : 


e RAH 
e 若 缓存 不 存在 ， 则 利用 函数 loadconfigurationFiles 加 载 配置 文件 


函数 loadConfigurationFiles 用 于 加 载 配置 文件 : 


protected function loadConfigurationFiles(Application $app, Repo 
sitoryContract $repository) 


{ 
foreach ($this->getConfigurationFiles($app) as $key => $path 
) í 
$repository->set($key, require $path); 


加 载 配置 文件 有 两 部 分 : 搜索 配置 文件 、 加 载 配 置 文件 的 数组 变量 值 


搜索 配置 文件 


getconfigurationFiles 可 以 根据 配置 文件 目录 搜索 所 有 的 php 为 后 缓 的 文 
件 ， 并 将 其 转化 为 ”files 数组 ， 其 key 为 目录 名 以 字符 . 为 连接 的 字符 串 
> value 为 文件 丨 实 路 径 : 


protected function getConfigurationFiles(Application $app) 


{ 
$files = []; 


$configPath = realpath($app->configPath()); 


foreach (Finder::create()->files()->name('*.php')->in($confi 
gPath) as $file) { 
$directory = $this->getNestedDirectory($file, $configPat 
h); 


$files[$directory.basename($file->getRealPath(), '.php') 
] = $file->getRealPath(); 


} 
return $files; 
} 
protected function getNestedDirectory(SplFileInfo $file, $config 
Path) 
t 


$directory = $file->getPath(); 


if ($nested = trim(str_replace($configPath, '', $directory), 
DIRECTORY_SEPARATOR)) { 
$nested = str_replace(DIRECTORY_SEPARATOR, '.', $nested). 


return $nested; 


j 
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加 载 配置 文件 数组 


加 载 配置 文件 由 类 IlluminateNConfigNRepositoryNLoadConfiguration % 
成 : 


class Repository 


{ 
public function set($key, $value = null) 
t 
$keys = is array($key) ? $key : [$key => $value]; 
foreach ($keys as $key => $value) { 
Arr: :set($this->items, $key, $value); 
} 
} 
} 


加 载 配 置 文件 时 间 上 就 是 将 所 有 配置 文件 的 数值 放 入 一 个 巨大 的 多 维 数组 中 ， 这 一 
部 分 由 类 Illuminate\Support\Arr 完成 : 


class Arr 
{ 
public static function set(&$array, $key, $value) 
{ 
if (is null($key)) { 
return $array = $value; 


$keys = explode('.', $key); 


while (count($keys) > 1) { 
$key = array_shift($keys); 


if (! isset($array[$key]) || ! is_array($array[$key ] 


$array[$key] = []; 
$array = &$array[$key]; 


$array[array shift($keys)] = $value; 


return $array; 


例如 diri.dir2.app ,配置 文件 会 生成 $array[dir1][dir2][app] 
组 。 


配置 文件 数值 的 获取 


当 我 们 利用 全 局 函数 config 来 获取 配置 值 的 时 候 : 


这 样 的 数 


function config($key = null, $default = null) 


1 
if (is null($key)) { 
return app('config'); 
J 
if (is array($key)) { 
return app('config')-»set(S$key); 
} 
return app('config')->get($key, $default); 
jy 


配置 文件 的 获取 和 加 载 类 似 ， 都 是 将 字符 串 转 为 多 维 数组 ， 然 后 获取 具体 数组 值 : 


public static function get($array, $key, $default = null) 
{ 
if (! static::accessible($array)) { 
return value($default); 


if (is_null($key)) ( 
return $array; 


if (static::exists($array, $key)) { 
return $array[$key]; 


foreach (explode('.', $key) as $segment) { 
if (static::accessible($array) && static::exists(S$array, 
$segment)) { 
$array = $array[$segment ]; 
) else { 
return value($default); 


return $array; 


对 于 一 个 优秀 的 框架 来 说 ， 正 确 的 异常 处 理 可 以 防止 暴露 自身 接口 给 用 户 ， 可 以 提 
供 快速 追溯 问题 的 提示 给 开发 人 人员。 本 文 会 详细 的 介绍 laravel 异常 处 理 的 源 
Hh e 


本 章节 参考 PHP 错 误 异 常 处 理 详解 。 


异常 处 理 〈 又 称 为 错误 处 理 ) 功能 提供 了 处 理 程序 运行 时 出 现 的 错误 或 异常 情况 的 
方法 。 异常 处 理 通常 是 防止 未 知 错误 产生 所 采取 的 处 理 措施 。 异 常 处 理 的 好 
处 是 你 不 用 再 绞 尽 脑汁 去 考虑 各 种 错误 ， 这 为 处 理 某 一 类 错误 提供 了 一 个 很 有 效 的 
方法 ， 使 编程 效率 大 大 提高 。 当 蜡 常 被 触发 时 ， 通 常会 发 生 : 


。 当前 代码 状态 被 保存 

e 代码 执行 被 切换 到 预定 义 的 异常 处 理 器 函数 

o 根据 情况 ， 处 理 器 也 许 会 从 保存 的 代码 状态 重新 开始 执行 代码 ， 终 止 脚本 执 
行 ， 或 从 代码 中 另外 的 位 置 继续 执行 脚本 


PHP 5 提供 了 一 种 新 的 面向 对 象 的 错误 处 理 方法 。 可 以 使 用 检测 (try) 、 抛 出 
(throw) 和 捕获 (catch) 异常 。 即 使 用 try 检 测 有 没有 抛 出 (throw) AF > SAH 
常 抛 出 (throw) ， 使 用 catch 捕 获 异 常 。 


一 个 try 至 少 要 有 一 个 与 之 对 应 的 catch。 定 义 多 个 catch 可 以 捕获 不 同 的 对 象 。 
php 会 按 这 些 catch 被 定义 的 顺序 执行 ， 直 到 完成 最 后 一 个 为 止 。 而 在 这 些 Catch 
内 ， 又 可 以 抛 出 新 的 异常 。 


措 第 的 抛 出 


当 一 个 异常 被 抛 出 时 ， 其 后 的 代码 将 不 会 继续 执行 ，PHP 会 尝试 查找 匹配 的 
catch 代码 块 。 如 果 一 个 异常 没有 被 捕获 ， 而 且 又 没 用 使 

用 set exception handler() 作 相 应 的 处 理 的 话 ， 那 么 Pup 将 会 产生 一 个 严 
重 的 错误 ， 并 且 输 出 未 能 捕获 异常 (Uncaught Exception ... ) 的 提示 信息 。 


抛 出 异常 ， 但 不 去 捕获 它 : 


ini_set('display_errors', 'On'); 
error_reporting(E_ALL & ~ E_WARNING); 
$error = 'Always throw this error'; 
throw new Exception($error); 

// 继续 执行 

echo 'Hello World'; 


上 面 的 代码 会 获得 类 似 这 样 的 一 个 致命 错误 : 


Fatal error: Uncaught exception 'Exception' with message 'Always 
throw this error' in E:\sngrep\index.php on line 5 
Exception: Always throw this error in E:\sngrep\index.php on lin 
e 5 
Call Stack: 
0.0005 330680 1. {main}() E:\sngrep\index.php:0 


Try, throw 和 catch 


要 避免 上 面 这 个 致命 错误 ， 可 以 使 用 try catchdd 3& 4$ » 
处 理 处 理 程序 应 当 包 括 : 


e Try - 使 用 异常 的 函数 应 该 位 于 "try" 代码 块 内 。 如 果 没 有 触发 异常 ， 则 代码 将 
照常 继续 执行 。 但 是 如 果 异 常 被 触发 ， 会 抛 出 一 个 异常 。 

e Throw - 这 里 规定 如 何 触发 异常 。 每 一 个 "throw" 必须 对 应 至 少 一 个 "catch" 

e Catch - "catch" 代码 块 会 捕获 异常 ， 并 创建 一 个 包含 异常 信息 的 对 象 


抛 出 异常 并 捕获 掉 ， 可 以 继续 执行 后 面 的 代码 : 


try +f 
$error = 'Always throw this error'; 


throw new Exception($error); 


// 从 这 里 开始 ，tra 代码 块 内 的 代码 将 不 会 被 执行 
echo 'Never executed'; 


) catch (Exception $e) { 
echo 'Caught exception: ',  $e-»getMessage(),'«br»'; 


// 继续 执行 
echo 'Hello World'; 


TRE JEU SLA set exception handler 


在 我 们 实际 开发 中 ， 异 常 捕 提 仅仅 靠 try () catch () 是 远 远 不 够 
的 。 set exception handler() 函数 可 设置 处 理 所 有 未 捕获 异常 的 用 户 定 义 函 
数 。 


function myException($exception) 


{ 


echo "<b>Exception:</b> " , $exception->getMessage(); 


j 


set exception handler('myException'); 
throw new Exception('Uncaught Exception occurred'); 


扩展 PHP 内 置 的 异常 处 理 类 


用 户 可 以 用 自 定义 的 异常 处 理 类 来 扩展 PHP. 内 置 的 异常 处 理 类 。 以 下 的 代码 说 明 
了 在 内 置 的 异常 处 理 类 中 ， 哪 些 属 性 和 方法 在 子 类 中 是 可 访问 和 可 继承 的 。 
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class Exception 


{ 

protected $message = 'Unknown exception'; // 异常 信息 

protected $code = 0; // 用 户 自 定义 异常 代 
码 

protected $file; // EU XT 

protected $line; // REFER AT 
m 

function _ construct($message = null, $code = 0); 

final function getMessage(); // 返回 异常 信息 

final function getCode(); // 返回 异常 代码 

final function getFile(); // 返回 发 生 异 常 的 文 
件 名 

final function getLine(); // 返回 发 生 异 常 的 代 
码 行 号 

final function getTrace(); // backtrace() 
数组 

final function getTraceAsString(); // 已 格 成 化 成 字符 串 


的 getTrace() 信息 


J* Te Rae */ 
function — toString(); // 可 输出 的 字符 串 


如 果 使 用 自 定义 的 类 来 扩展 内 置 异 党 处 理 类 ， 并 且 要 重新 定义 构造 函数 的 话 ， 建 议 
同时 调用 parent:: construct() 来 检查 所 有 的 变量 是 否 已 被 赋值 。 当 对 象 要 
输出 字符 串 的 时 候 ， 可 以 重 载 _ toString() 并 自 定义 输出 的 样式 。 
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class MyException extends Exception 
{ 


// 重 定义 构造 器 使 message 变 为 必须 被 指定 的 属性 

public function __construct($message, $code = 0) { 
// 自 定义 的 代码 

// 确保 所 有 变量 都 被 正确 赋值 

parent:: 


. construct($message, $code); 
} 


// 自 定义 字符 串 输 出 


public function 


=COSserang( et 
facts tee E LASS mae 
Hn 


的 样式 */ 


[{$this->code}]: {$this->message}\ 


public function customFunction() { 


echo "A Custom function for this type of exception\n" 
} 


MyException 类 是 作为 晶 的 exception 类 的 一 个 扩展 来 邓 


的 。 这 样 它 就 继承 了 
getLine() 、 


-— * - |a J o ix 
加 类 的 所 有 属性 和 方法 ， 我 们 可 以 使 用 exception 类 的 方法 ， 比 如 


PHP 434 


getFile() 以 及 getMessage() 


o 


AX 理 


PHP 的 错误 级 别 
值 常量 说 明 
命 的 运行 时 错误 。 这 类 错误 一 般 是 
可 恢复 的 情况 ， 例 如 内 存 分 配 导 和 致 
1 E ERROR SHE a 
续 运 行 。 
2 E WARNING J 


命 错误 )。 仅 给 出 提 
息 i S 终止 运行 


o 


16 


32 


64 


128 


256 


512 


1024 


2048 


4096 


E PARSE 


E NOTICE 


E CORE ERROR 


E CORE WARNING 


E COMPILE ERROR 


E COMPILE WARNING 


E USER ERROR 


E USER. WARNING 


E USER NOTICE 


E STRICT 


E RECOVERABLE ERROR 


编译 时 语法 解析 错误 。 解 析 错 误 仅 仅 
由 分 析 器 产生 。 


运行 时 通知 。 表 示 脚 本 遇 到 可 能 会 表 
现 为 错误 的 情况 ， 但 是 在 可 以 正常 运 
行 的 脚本 里 面孔 可 能 会 有 类 似 的 通 

知 。 


在 PHP 初 始 化 启动 过 程 中 发 生 的 致命 
错误 。 该 错误 类 似 E_ERROR， 但 是 
是 由 PHP 引 人 擎 核心 产生 的 。 


PHP 初 始 化 启动 过 程 中 发 生 的 警告 
( 非 致 命 错误 ) o RW 

E_WARNING， 但 是 是 由 PHP 引 擎 核 
心 产生 的 。 


致命 编译 时 错误 。 类 似 E_ERROR， 
但 是 是 由 Zend 脚 本 引擎 产生 的 。 


编译 时 警告 ( 非 致命 错误 )。 类 似 
E_WARNING， 但 是 是 由 Zend 脚 本 
引擎 产生 的 。 


用 户 产 生 的 错误 信息 。 类 似 
E_ERROR, 但 是 是 由 用 户 自 己 在 代 
码 中 使 用 PHP 有 函数 trigger_error() 来 
产生 的 。 


用 户 产 生 的 警告 信息 。 类 似 

E WARNING, 但 是 是 由 用 户 自己 在 
代码 中 使 用 PHP 驾 数 trigger_error() 
来 产生 的 。 


用 户 产生 的 通知 信息 。 类 似 
E_NOTICE, 但 是 是 由 用 户 自己 在 代 
5 v 4$ PHP: trigger. error()& 
产生 的 。 


启用 PHP 对 代码 的 修改 建议 ， 以 确 
保 代 码 具 有 最 佳 的 互 操 作 性 和 向 前 兼 
容 性 。 


可 被 捕捉 的 致命 错误 。 它 表示 发 生 
了 一 个 可 能 非常 危险 的 错误 ， 但 是 还 
没有 导致 PHP 引 擎 处 于 不 稳定 的 状 
Ao 如 果 该 错误 没有 被 用 户 自 定 义 
句柄 捕获 (参见 
set_error_handler())， 将 成 为 一 个 

E ERROR 从 而 脚本 会 终止 运行 。 


运行 时 通知 。 启 用 后 将 会 对 在 未 来 版 


8192 E DEPRECATED 本 中 可 能 无 法 正常 工作 的 代码 给 出 警 
BZ 


用 户 产 少 的 警告 信息 。 类 似 

E DEPRECATED, 但 是 是 由 用 户 自 
己 在 代码 中 使 用 PHP 遂 数 
trigger_error() 来 产生 的 。 


用 户 产 少 的 警告 信息 。 RV 

E DEPRECATED, 但 是 是 由 用 户 自 
己 在 代码 中 使 用 PHP 志 数 
trigger_error() 来 产生 的 。 


16384 E USER DEPRECATED 


30719 E ALL 


错误 的 抛 出 


除了 系统 在 运行 php 代码 抛 出 的 意外 错误 。 我 们 还 可 以 利用 rigger error 产生 
一 个 自 定义 的 用 户 级 别 的 error/warning/notice 错误 信息 : 


if ($divisor == 0) { 
trigger error("Cannot divide by zero", E USER ERROR); 


IR FE dX ABIEX 


顶级 错误 处 理 器 set error handler 一 般 用 于 捕捉 E NOTICE 

` E USER ERROR ^ E USER WARNING ^ E USER NOTICE 级 别 的 错误 ， 不 能 捕 
4& E ERROR , E PARSE , E CORE ERROR , E CORE WARNING , 

E COMPILE ERROR 和 E COMPILE WARNING ° 


register shutdown function 


register shutdown function() 函数 可 实现 当 程 序 执行 完成 后 执行 的 函数 ， 其 
功能 为 可 实现 程序 执行 完成 的 后 续 操作 。 程 序 在 运行 的 时 候 可 能 存在 执行 超时 ， 或 
强制 关闭 等 情况 ， 但 这 种 情况 下 默认 的 提示 是 非常 不 友好 的 ， 如 果 使 用 

register shutdown function() 函数 捕获 异常 ， 就 能 提供 更 加 友好 的 错误 展示 
方式 ， 同 时 可 以 实现 一 些 功能 的 后 续 操作 ， 如 执行 完成 后 的 临时 数据 清理 ， 包 括 临 
时 文件 等 。 


可 以 这 样 理解 调用 条 件 : 


e 当 页 面 被 用 户 强 制 停止 时 
o 当 程序 代码 运行 超时 时 
e 当 己 再 P 代 码 执行 完成 时 ， 代 码 执行 存在 异常 和 错误 、 警 告 


我 们 前 面 说 过 ， set_error_handler 能 够 捕 提 的 错误 类 型 有 限 ， 很 多 致命 错误 
例如 解析 错误 等 都 无 法 捕捉 ， 但 是 这 类 致命 错误 发 生 时 ，PHP 会 调用 

register shutdown function 所 注册 的 函数 ， 如 果 结 合 函 数 
error_get_last ， 就 会 获取 错误 发 生 的 信息 


o 
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laravel 的 异常 处 理由 类 
\Illuminate\Foundation\Bootstrap\HandleExceptions::class 完成 : 


class HandleExceptions 


{ 


public function bootstrap(Application $app) 
{ 
$this->app = $app; 
error_reporting(-1); 
set_error_handler([$this, 'handleError']); 
set_exception_handler([$this, 'handleException']); 


register_shutdown_function([$this, 'handleShutdown']); 


if (! $app->environment('testing')) { 
inil set (display errors.) Torny 


Ft Fe 


laravel 的 异常 处 理 均 由 函数 handleException 负责 。 


PHP7 实现 了 一 个 全 局 的 throwable 接口 ， 原 来 的 Exception 和 部 分 
Error 都 实现 了 这 个 接口 ， 以 接口 的 方式 定义 了 异常 的 继承 结构 。 于 

x^ PHP7 中 更 多 的 Error ATHARI Exception 返回 给 开发 者 ， 如 果 不 
进行 捕获 则 为 ”Error i bind Co MN Ld 内 处 理 的 Exception ° 
这 些 可 被 捕获 的 Error 通常 都 是 不 会 对 程序 造成 致命 伤害 的 Error ， 例 如 函数 


不 存在 。 


PHP7 中 ， 基 于 /Error exception ， 派 生 了 5 个 新 的 engine 

exception: ArithmeticError / AssertionError / DivisionByZeroError / 
ParseError / TypeError ° Æ PHP7 里 ， 无 论 是 老 的 /Exception 还 是 新 
的 /Error ， 它 们 都 实现 了 一 个 共同 的 interface: /Throwable 。 


因此 ， 遇 到 非 Exception 类 型 的 异常 ， 首 先 就 要 将 其 转化 为 
FatalThrowableError 类 型 : 


public function handleException($e) 


í 


if (! $e instanceof Exception) { 
$e = new FatalThrowableError($e); 


$this->getExceptionHandler()->report($e); 


if ($this->app->runningInConsole()) { 
$this-»renderForConsole($e); 

) else { 
$this->renderHttpResponse($e); 


FatalThrowableError 是 Symfony 继承 wErrorException 的 错误 异常 
类 : 


class FatalThrowableError extends FatalErrorException 


{ 


public function __construct(\Throwable $e) 


t 

if ($e instanceof \ParseError) { 
$message = 'Parse error: '.$e->getMessage(); 
$severity = E_PARSE; 

} elseif ($e instanceof \TypeError) 1 
$message = 'Type error: '.$e->getMessage(); 
$severity = E_RECOVERABLE_ERROR; 

} else { 
$message = $e->getMessage(); 
$severity = E_ERROR; 

} 

NErrorException::  construct( 
$message, 
$e->getCode(), 
$severity, 
$e->getFile(), 
$e->getLine() 

); 

$this->setTrace($e->getTrace()); 

} 


异常 Log 


当 遇 到 异常 情况 的 时 候 ， laravel 首要 做 的 事情 就 是 记录 log ， 这 个 就 是 
report 函数 的 作用 。 


protected function getExceptionHandler() 


( 


return $this->app->make(ExceptionHandler::class); 


laravel 在 Ioc 容器 中 默认 的 异常 处 理 类 是 


IlluminateNFoundationNExceptionsNHandler 


class Handler implements ExceptionHandlerContract 


{ 
public function report(Exception $e) 
{ 
if ($this->shouldntReport($e)) { 
return; 
} 
try { 
$logger = $this->container->make(LoggerInterface::cl 
ass); 
} catch (Exception $ex) { 
throw $e; // throw the original exception 
} 
$logger->error($e); 
} 


protected function shouldntReport(Exception $e) 


{ 
$dontReport = array_merge($this->dontReport, [HttpRespon 


seException: :class]); 


return ! is_null(collect($dontReport)->first(function ($ 
type) use ($e) { 
return $e instanceof $type; 


})); 


He ROR 


记录 log 后 ， 就 要 将 异常 转化 为 页 面向 开发 者 展示 异常 的 信息 ， 以 便 查看 问题 的 
来 源 : 


protected function renderHttpResponse(Exception $e) 


$this->getExceptionHandler()->render($this->app['request'], 
$e)->send(); 


} 


class Handler implements ExceptionHandlerContract 


£ 


public function render($request, Exception $e) 


{ 


$e = $this->prepareException($e); 


if ($e instanceof HttpResponseException) { 
return $e->getResponse(); 
} elseif ($e instanceof AuthenticationException) { 
return $this->unauthenticated($request, $e); 
} elseif ($e instanceof ValidationException) { 
return $this->convertValidationExceptionToResponse($ 
e, $request); 


j 


return $this-»prepareResponse($request, $e); 


对 于 不 同 的 异常 ， laravel 有 不 同 的 处 理 ， 大 致 有 

HttpException ^ HttpResponseException ^ AuthorizationException ^ 
ModelNotFoundException ^ AuthenticationException ^ ValidationExcep 
tion 。 由 于 特定 的 不 同 异 常 带 有 自身 的 不 同 需求 ， 本 文 不 会 特别 介绍 。 本 文 继续 
介绍 最 普通 的 异常 HttpException 的 处 理 : 


protected function prepareResponse($request, Exception $e) 
1 
if ($this->isHttpException($e)) { 
return $this->toIlluminateResponse($this->renderHttpExce 
ption($e), $e); 
) else { 
return $this->toIlluminateResponse($this->convertExcepti 
onToResponse($e), $e); 


} 


protected function renderHttpException(HttpException $e) 


{ 
$status = $e->getStatusCode(); 


view()-»replaceNamespace('errors', [ 
resource path('views/errors'), 
_DIR .'/views', 


]); 


if (view()->exists("errors::{$status}")) { 
return response()->view("errors::{$status}", ['exception' 
=> $e], $status, $e->getHeaders()); 
} else { 
return $this->convertExceptionToResponse($e); 


j 
E ===> == 


对 于 HttpException 来 说 ， 会 根据 其 错误 的 状态 码 ， 选 取 不 同 的 错误 页 面 模 
板 ， 若 不 存在 相关 的 模板 ， 则 会 通过 SymfonyResponse 来 构造 异常 展示 页 面 : 


protected function convertExceptionToResponse(Exception $e) 


{ 


$e = FlattenException: :create($e); 
$handler = new SymfonyExceptionHandler(config('app.debug')); 


return SymfonyResponse: :create($handler->getHtml($e), $e->ge 
tStatusCode(), $e->getHeaders()); 
} 


protected function toIlluminateResponse($response, Exception $e) 
{ 
if ($response instanceof SymfonyRedirectResponse) { 
$response = new RedirectResponse($response->getTargetUrl 
(), $response-»getStatusCode(), $response->headers->all()); 
) else { 
$response = new Response($response->getContent(), $respo 
nse->getStatusCode(), $response->headers->all()); 


} 


return $response->withException($e); 


laravel 错误 处 理 


public function handleError($level, $message, $file = '', $line 
= 0, $context = []) 


{ 
if (error_reporting() & $level) { 
throw new ErrorException($message, 0, $level, $file, $1i 
ne); 
} 
} 


public function handleShutdown() 


Y 
if (! is null(S$error = error get last()) && $this->isFatal($ 


error['type'])) 1 
$this->handleException($this->fatalExceptionFromError($e 


rror, 9)); 


} 


protected function fatalExceptionFromError(array $error, $traceO 
ffset - null) 
{ 


return new FatalErrorException( 
$error['message'], $error['type'], 0, $error['file'], $e 
rror['line'], $traceOffset 


): 


protected function isFatal($type) 


t 
return in array($type, [E COMPILE ERROR, E CORE ERROR, E ERR 


OR, E PARSE]); 
} 


对 于 不 致命 的 错误 ， 例 如 notice 级 别 的 错误 ，handleError PTAR > 
laravel 将 错误 转化 为 了 异常 ， 交 给 了 handleException 去 处 理 。 


对 于 致命 错误 ， 例 如 E PARSE 解析 错误 ， handleShutdown 将 会 启动 ， 并 且 判 
断 当前 脚本 结束 是 否 是 由 于 致命 错误 ， 如 果 是 致命 错误 ， 将 会 将 其 转化 为 
FatalErrorException , 交 给 了 handleException 作为 异常 去 处 理 。 
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服务 提供 者 是 laravel 框架 的 重要 组 成 部 分 ， 承 载 着 各 种 服务 ， 自 定义 的 应 用 以 
及 所 有 Laravel 的 核心 服务 都 是 通过 服务 提供 者 启动 。 本 文 将 会 介绍 服务 提供 者 
的 源码 分 析 ， 关 于 服务 提供 者 的 使 用 ， 请 参考 官方 文档 : 服务 提供 者 。 


服务 提供 者 的 注册 


服务 提供 者 的 启动 由 类 
\Illuminate\Foundation\Bootstrap\RegisterProviders::class 负责 ， 该 
类 用 于 加 载 所 有 服务 提供 者 的 register 函数 ， 并 保存 延迟 加 载 的 服务 的 信息 ， 
以 便 实 现 延 迟 加 载 。 


class RegisterProviders 


{ 
public function bootstrap(Application $app) 
{ 
$app->registerConfiguredProviders(); 
} 
} 


class Application extends Container implements ApplicationContra 
ct, HttpKernelInterface 
{ 


public function registerConfiguredProviders() 
{ 
(new ProviderRepository($this, new Filesystem, $this->ge 
tCachedServicesPatn( ) ) ) 
->load($this->config['app.providers']); 


} 
public function getCachedServicesPath() 
{ 
return $this->bootstrapPath().'/cache/services.php'; 
} 


以 上 可 以 看 出 ， 所 有 服务 提供 者 都 在 配置 文件 app.php 文件 的 providers X 
组 中 。 类 providerRepository 负责 所 有 的 服务 加 载 功 能 : 


class ProviderRepository 


{ 


public function load(array $providers) 
{ 
$manifest = $this->loadManifest(); 
if ($this->shouldRecompile($manifest, $providers)) { 


$manifest = $this->compileManifest($providers); 


foreach ($manifest['when'] as $provider => $events) { 
$this->registerLoadEvents($provider, $events); 


foreach ($manifest['eager'] as $provider) { 
$this->app->register($provider ); 


$this->app->addDeferredServices($manifest['deferred']); 


加 载 服务 缓存 文件 


laravel 会 把 所 有 的 服务 整理 起 来 ， 作 为 缓存 写 在 缓存 文件 中 : 


Laravel Providers 服务 提供 者 的 注册 与 启动 源码 解析 





return array ( 
'providers' => 
array ( 
9 => 'Tlluminate\\Auth\\AuthServiceProvider', 
1 => 'Illuminate\\Broadcasting\\BroadcastServiceProvider', 


); 


'eager' => 
array ( 
© => 'IlluminateNNAuthNNAuthServiceProvider', 
1 => 'IlluminateNNCookieNNCookieServiceProvider', 


); 


'deferred' => 
array ( 
'IlluminateNNBroadcastingNNBroadcastManager' => 'Illuminat 
e\\Broadcasting\\BroadcastServiceProvider', 
'IlluminateNNContractsNNBroadcastingNNFactory' => 'Illumin 
ate\\Broadcasting\\BroadcastServiceProvider', 


); 


'when' => 

array ( 
'IlluminateNNBroadcastingNNBroadcastServiceProvider' => 
array ( 


); 


); 


缓存 文件 中 providers 放 入 了 所 有 自 定义 和 框架 核心 的 服务 。 
e eager 数组 中 放 入 了 所 有 需要 立即 启动 的 服务 提供 者 。 
deferred 数组 中 放 入 了 所 有 需要 延迟 加 载 的 服务 提供 者 。 

e when 放 入 了 延迟 加 载 需要 激活 的 事件 。 


加 载 服务 提供 者 缓存 文件 : 
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public function loadManifest() 


{ 
if ($this->files->exists($this->manifestPath)) { 
$manifest = $this->files->getRequire($this->manifestPath 
); 
if ($manifest) { 
return array merge(['when' => []], $manifest); 
} 
} 
} 


编译 服务 提供 者 


若 laravel 中 的 服务 提供 者 没有 缓存 文件 或 者 有 变动 ， 那 么 就 会 重新 生成 缓存 文 
件 : 


public function shouldRecompile($manifest, $providers) 


{ 


return is null($manifest) || $manifest['providers'] != $prov 
iders; 
} 
protected function compileManifest($providers) 
{ 
$manifest = $this->freshManifest($providers); 
foreach ($providers as $provider) { 
$instance = $this->createProvider ($provider ); 
if ($instance->isDeferred()) { 
foreach ($instance->provides() as $service) { 
$manifest['deferred'][$service] = $provider; 
} 
$manifest['when'][$provider] = $instance->when(); 
} 
else { 
$manifest['eager'][] = $provider; 
} 
} 
return $this-»writeManifest($manifest); 
} 


protected function freshManifest(array $providers) 


{ 


return ['providers' => $providers, 'eager' => [], 'deferred' 
=> []]; 
} 


o 如 果 服 务 提 供 者 是 需要 立即 注册 的 ， 那 么 将 会 放 入 缓存 文件 中 eager 数组 
中 。 

e 如 果 服 务 提 供 者 是 延迟 加 载 的 ， 那 么 其 函数 provides() 通常 会 提供 服务 别 
名 ， 这 个 服务 别名 通常 是 向 服务 容器 中 注册 的 别名 ， 别 名 将 会 放 入 缓存 文件 的 


deferred 数组 中 。 
e 延迟 加 载 若 有 event 事件 激活 ， 那 么 可 以 在 when 函数 中 写 入 事件 类 ， 并 
写 入 缓存 文件 的 when 数组 中 。 


延迟 服务 提供 者 事件 注册 


延迟 服务 提供 者 除了 利用 roc 容器 解析 服务 方式 激活 ， 还 可 以 利用 Event + 
件 来 激活 : 


protected function registerLoadEvents($provider, array $events) 
{ 
if (count($events) < 1) { 
return; 


$this->app->make('events')->listen($events, function () use 
(Sprovider) ( 
$this-»app-»register($provider); 


3): 


注册 即时 启动 的 服务 提供 者 
服务 提供 者 的 注册 函数 register() 由 类 Application 来 调用 : 


class Application extends Container implements ApplicationContra 
ct, HttpKernellnterface 
{ 

public function register($provider, $options = [], $force = 
false) 

{ 

if (($registered = $this->getProvider($provider)) && ! $ 
force) { 
return $registered; 


if (is_string($provider)) { 


$provider = $this->resolveProvider ($provider ); 


if (method_exists($provider, 'register')) { 
$provider-»register(); 


$this->markAsRegistered($provider ); 


if ($this->booted) { 
$this->bootProvider($provider); 


return $provider; 


public function getProvider($provider ) 
{ 
$name = is_string($provider) ? $provider : get_class($pr 
ovider); 


return Arr::first(S$this-»-serviceProviders, function ($va 
lue) use ($name) { 
return $value instanceof $name; 


3); 
} 
public function resolveProvider($provider) 
{ 
return new $provider($this); 
} 


protected function markAsRegistered($provider ) 
{ 


$this->serviceProviders[] = $provider; 


$this->loadedProviders[get_class($provider)] = true; 


protected function bootProvider(ServiceProvider $provider ) 


if (method_exists($provider, 'boot')) { 
return $this->call([$provider, 'boot']); 


可 以 看 出 ， 服 务 提供 者 的 注册 过 


e 判断 当前 服务 提供 者 是 否 被 注册 过 ， 如 注册 过 直接 返回 对 象 

e 解析 服务 提供 者 

e 调用 服务 提供 者 的 register 函数 

e 标记 当前 服务 提供 者 已 经 注册 完毕 

e 若 框 架 已 经 加 载 注册 完毕 所 有 的 服务 容器 ， 那 么 就 启动 服务 提供 者 的 boot 
函数 ， 该 函数 由 于 是 call 调用 ， 所 以 支持 依赖 注入 。 


RAR F He 供 者 激 Ve 与 注 
迟 服务 提供 者 首先 需要 添加 到 Application 中 : 


public function addDeferredServices(array $services) 


1 
$this->deferredServices = array merge($this-»deferredService 
S, $services); 


j 


我 们 之 前 说 过 ， 延 迟 服 务 提 供 者 的 激活 注册 有 两 种 方法 : 事件 与 服务 解析 。 


当 特 定 的 事件 被 激发 后 ， 就 会 调用 Application 的 register 有 函数 ， 进 而 调用 
服务 提供 者 的 register 函数 ， 实 现 服 务 的 注册 。 


当 利 用 Ioc 容器 解析 服务 名 时 ， 例 如 解析 服务 名 BroadcastingFactory 


class BroadcastServiceProvider extends ServiceProvider 


{ 


protected $defer = true; 


public function provides() 


{ 
return [ 
BroadcastManager::class, 
BroadcastingFactory::class, 
BroadcasterContract::class, 
l; 
J 


public function make($abstract) 


Y 
$abstract = $this->getAlias($abstract); 
if (isset($this->deferredServices[$abstract])) { 
$this->loadDeferredProvider($abstract); 
} 
return parent: :make($abstract ); 
} 


public function loadDeferredProvider($service) 


{ 
if (! isset($this->deferredServices[$service])) { 
return; 


$provider = $this->deferredServices[$service]; 


if (! isset($this->loadedProviders[$provider])) { 
$this->registerDeferredProvider($provider, $service); 


由 deferredServices 数组 可 以 得 知 ， BroadcastingFactory 为 延迟 服务 ， 
接着 程序 会 利用 函数 loadDeferredProvider 来 加 载 延 迟 服务 提供 者 ， 调 用 服务 
提供 者 的 register 哆 数 ， 若 当前 的 框架 还 未 注册 完全 部 服务 。 那 么 将 会 放 入 服 
务 启动 的 回调 函数 中 ， 以 待 服务 启动 时 调用 : 


public function registerDeferredProvider($provider, $service - n 
ull) 


{ 
if ($service) { 
unset($this->deferredServices[$service]); 


$this->register($instance = new $provider($this)); 
if (! $this->booted) { 


$this->booting(function () use ($instance) { 
$this->bootProvider($instance); 


}); 


关于 服务 提供 者 的 注册 函数 : 


class BroadcastServiceProvider extends ServiceProvider 


{ 


protected $defer = true; 


public fünctron register( ) 


i 


$this->app->singleton(BroadcastManager::class, function 


(Sapp) { 
return new BroadcastManager($app); 


3): 


$this->app->singleton(BroadcasterContract::class, functi 


on ($app) 1 
return $app->make(BroadcastManager: :class) ->connecti 


on(); 
3): 
$this-»app-»alias( 
BroadcastManager::class, BroadcastingFactory::class 
); 
} 
public function provides() 
{ 
return [ 
BroadcastManager::class, 
BroadcastingFactory::class, 
BroadcasterContract::class, 
]; 
J 


函数 register AX BroadcastingFactory 向 Ioc 容器 绑 定 了 特定 的 实现 
类 BroadcastManager ， 这 样 Ioc 容器 中 的 make HH: 


public function make($abstract) 


1 
$abstract = $this-»getAlias($abstract); 
if (isset($this->deferredServices[$abstract])) { 
$this->loadDeferredProvider($abstract); 
} 
return parent: :make($abstract ); 
jy 


parent::make($abstract) 就 会 正确 的 解析 服务 BroadcastingFactory ° 


因此 函数 provides() 返回 的 元 素 一 定 都 是 register() 向 Ioc 容器 中 绑 定 

的 类 名 或 者 别名 。 这 样 当 我 们 利用 服务 容器 来 利用 App::make() 解析 这 些 类 名 

的 时 候 ， 服 务 容器 才 会 根据 服务 提供 者 的 register() 函数 中 绑 定 的 实现 类 ， 从 
而 正确 解析 服务 功能 。 


服务 容器 的 户 动 


服务 容器 的 启动 由 类 


\Illuminate\Foundation\Bootstrap\BootProviders::class 负责 : 


class BootProviders 


{ 
public function bootstrap(Application $app) 
{ 
$app->boot(); 
} 
} 


class Application extends Container implements ApplicationContra 
ct, HttpKernelInterface 


{ 


public function boot() 


{ 
if ($this->booted) { 
return; 


$this->fireAppCallbacks($this->bootingCallbacks); 


array_walk($this->serviceProviders, function ($p) { 
$this->bootProvider($p); 
3); 


$this->booted = true; 


$this->fireAppCallbacks($this->bootedCallbacks) ; 


protected function bootProvider(ServiceProvider $provider ) 
{ 
if (method_exists($provider, 'boot')) { 
return $this->call([$provider, 'boot']); 


数据 库 是 laravel 及 其 重要 的 组 成 部 分 ， 大 致 的 讲 ， laravel 的 数据 库 功 能 
可 以 分 为 两 部 分 : 数据 库 DB 、 数 据 库 Eloquent Model 。 数 据 库 的 
Eloquent 是 功能 十 分 丰富 的 ORM ， 让 我 们 可 以 避免 写 繁 杂 的 sql 语句 。 数 
据 库 DB 是 比较 底层 的 与 pdo 交互 的 功能 ， Eloquent 的 底层 依赖 于 DB ° 
本 文 将 会 介绍 数据 库 DB 中 关于 数据 库 服务 的 启动 与 连接 部 分 。 


在 详细 讲解 数据 库 各 个 功能 之 前 ， 我 们 先 看 看 支撑 着 整个 laravel 数据 库 功 能 的 
框架 : 









DB::table(‘usr’)- 
>select() 







DB::table(‘usr')->insert() 


DB::update() 


DatabaseManager 
connection() 
ConnectionFactor 
y:make() 
ConnectionFactor 
y:PdoResolver() 
Connection 

update() 


$pdo- 
>execute() 















Connector::connect() 


Connection 
insert() 





Connection 
select() 





e DB 也 就 是 DatabaseManager ， 承 担 着 数据 库 接 口 的 工作 ， 一 切 数据 库 相 
关 的 操作 ， 例 如 查询 、 更 新 、 插 入 、 删 除 都 可 以 通过 DB 这 个 接口 来 完成 。 
但 是 ， 具 体 的 调用 pdo API 的 工作 却 不 是 由 该 类 完成 的 ， 它 仅仅 是 一 个 对 外 
的 接口 而 已 。 


e ConnectionFactory 顾名思义 专门 为 DB 构造 初始 化 

connector ^ connection 对 象 ， 

e connector 负责 数据 库 的 连接 功能 ， 为 保障 程序 的 高 效 ， laravel 将 其 包 
RMA BB HA BAMA connection 的 一 个 成 员 对 象 ， 实 现 懒 
加 载 。 

e connection 负责 数据 库 的 具体 功能 ， 负 责 底 层 与 pdo API 的 交互 。 


数据 库 服 务 的 注册 与 局 


数据 库 服 务 也 是 一 种 服务 提供 


zt: IlluminateNDatabaseNDatabaseServiceProvider 


public function register() 


{ 
Model: :clearBootedModels(); 
$this-»registerConnectionServices(); 
$this->registerEloquentFactory(); 
$this->registerQueueableEntityResolver(); 
} 


我 们 先 来 看 这 个 注册 函数 的 第 一 名 : Model::clearBootedModels() 。 这 一 名 其 
实 是 为 了 Eloquent 服务 的 启动 做 准备 。 数 据 库 的 Eloquent Model 有 一 个 静 
态 的 成 员 变量 数组 $booted ， 这 个 静态 数组 存储 了 所 有 已 经 被 初始 化 的 数据 库 
model ， 以 便 加 载 数据 库 模 型 时 更 加 迅速 。 因 此 ， 在 Eloquent 服务 启动 之 前 
需要 初始 化 静态 成 员 变量 $booted 

public static function clearBootedModels() 

1 


static::$booted = []; 


static::$globalScopes - []; 


接 下 来 我 们 就 开始 看 数据 库 服 务 的 注册 最 重要 的 两 部 分 : ConnectionServices 
与 Eloquent . 


ConnectionServices 注册 


protected function registerConnectionServices() 


{ 
$this->app->singleton('db.factory', function ($app) { 


return new ConnectionFactory($app); 


3); 


$this->app->singleton('db', function ($app) { 
return new DatabaseManager($app, $app['db.factory']); 


3); 


$this->app->bind('db.connection', function ($app) { 
return $app['db']-»connection(); 


3); 


可 以 看 出 ， 数 据 库 服务 向 IOC 容器 注册 了 db ^ db.factory 4 
db.connection ° 
e 最 重要 的 英 过 于 db 对 象 ， 它 有 一 个 Facade 是 DB ， 我 们 可 以 利用 
DB::connection() 来 连接 任意 数据 库 ， 可 以 利用 DB::select() 来 进行 
数据 库 的 查询 ， 可 以 说 DB 就 是 我 们 操作 数据 库 的 接口 。 
e db.factory 负责 为 DB 创建 connector 提供 数据 库 的 底层 连接 服务 ， 
负责 为 DB 创建 connection 对 象 来 进行 数据 库 的 查询 等 操作 。 
e db.connection 是 laravel 用 于 与 数据 库 pdo 接口 进行 交互 的 底层 
类 ， 可 用 于 数据 库 的 查询 、 更 新 、 创 建 等 操作 。 


Eloquent 注册 


protected function registerEloquentFactory( ) 


1 
$this->app->singleton(FakerGenerator::class, function () { 
return FakerFactory: :create(); 
3): 
$this->app->singleton(EloquentFactory::class, function ($app) 
{ 
return EloquentFactory: :construct ( 
$app->make(FakerGenerator::class), database_path('fa 
ctories') 
); 
3); 
} 


EloquentFactory 用 于 创建 Eloquent Model ， 用 于 全 局 函数 factory() 
来 创建 数据 库 模型 。 


数据 库 服务 的 局 动 
public function boot() 
{ 
Model: :setConnectionResolver($this->app['db']); 
Model: :setEventDispatcher($this->app['events']); 
} 


数据 库 服 务 的 启动 主要 设置 Eloquent Model 的 connection resolver > M 
于 数据 库 模 型 model 利用 db 来 来 连接 数据 库 。 还 有 设置 数据 库 事件 的 分 发 器 
dispatcher ， 用 于 监听 数据 库 的 事件 。 


DatabaseManager 一 一 数据 库 的 接口 


如 果 我 们 想 要 使 用 任何 数据 库 服务 ， 首 先 要 做 的 事情 当然 是 利用 用 户 名 与 密码 来 连 
接 数据 库 。 在 laravel 中 ， 数 据 库 的 用 户 名 与 密码 一 般 放 在 .env 文件 中 或 者 
放 入 nginx 配置 中 ， 并 且 利用 数据 库 的 接口 DB 来 与 pdo 进行 交互 ， 利 用 
pdo 来 连接 数据 库 。 


DB 即 是 类 Illuminate\Database\DatabaseManager ， 首 先 我 们 来 看 看 其 构 


public function __construct($app, ConnectionFactory $factory) 


{ 
$this->app = $app; 
$this->factory = $factory; 


我 们 称 DB 为 一 个 接口 ， 或 者 是 一 个 门面 模式 ， 是 因为 数据 库 操作 ， 例 如 数据 库 
的 连接 或 者 查询 、 更 新 等 操作 均 不 是 DB 的 功能 ， 数 据 库 的 连接 使 用 类 
Illuminate\Database\Connectors\Connector 完成 ， 数 据 库 的 查询 等 操作 由 
类 Illuminate\Database\Connection 完成 ， 


因此 ， 我 们 不 必 直 接 操作 connector 或 者 connection ， 仅 仅 会 操作 DB FP 
RE 


那么 DB 是 如 何 实 现 connector 或 者 connection 的 功能 的 呢 ? 关键 还 是 这 
个 ConnectionFactory 类 ， 这 个 工厂 类 专门 为 DB 来 生成 connection 对 
象 ， 并 将 其 放 入 DB 的 成 员 变量 数组 $connections 中 去 。 connection 中 会 
包含 connector 对 和 象 来 实现 数据 库 的 连接 工作 。 


class DatabaseManager implements ConnectionResolverInterface 


{ 
protected $app; 


protected $factory; 
protected $connections = []; 


public function __call($method, $parameters) 


{ 


return $this-»connection()-»$method(...$parameters); 


魔术 有 函数 实现 了 DB 与 connection 的 无 颖 连接， 任何 对 数据 库 的 操作 ， 例 如 
DB::select() ^ DB::table('user')-»save() ， 都 会 被 转移 至 


connection 中 去 。 


connection X 





JR CAES BE EEA R 


public function connection($name = null) 


1 
list($database, $type) = $this->parseConnectionName($name) ; 
$name = $name ?: $database; 
if (! isset($this->connections[$name])) { 
$this->connections[$name] = $this->configure( 


$connection = $this->makeConnection($database), 
$type 


return $this->connections[$name]; 


具体 流程 如 下 i 


DatabaseManager::connection 
0 


0 
list($database, 
$type) 


connections[$name]? 


: I 
F makeConnection() 


3 configuration() 


factory->make($config, 
$name) 


configure() 










parseConnectionName 


0 


getDefaultConnection() : 







configuration() 


人 getDefaultConnection() E 
] i 














list($database, 
$type) 








: app[‘config'] 
3 ['database.connections' 
$name 









E setReadPdo($connectio setPdo($connectio 
; n->getPdo()) n->getReadPdo()) 


DB 的 connection BHAT AAE A EE E JA Fo T A RRITAR > MAS 
连接 默认 数据 库 ， 默 认 数据 库 的 设置 在 config/database 文件 中 。 


connection AX AH : 


e 解析 数据 库 名 称 与 数据 库 类 型 ， 例 如 只 读 、 写 
e 若 没 有 创建 过 与 该 数据 库 的 连接 ， 则 开始 创建 数据 库 连 接 
e 返回 数据 库 连 接 对 象 connection 


protected function parseConnectionName($name ) 


{ 

$name = $name ?: $this->getDefaultConnection(); 

return Str::endsWith($name, ['::read', '::write']) 

? explode('::', $name, 2) : [$name, null 

l; 
} 
public function getDefaultConnection() 
{ 

return $this->app['config']['database.default']; 
} 


可 以 看 出 ， 若 没有 特别 指定 连接 的 数据 库 名 称 ， 那 么 就 会 利用 文件 
EARE E 文件 中 设置 的 default 数据 库 名 称 作 为 默认 连接 数据 库 名 

若 数 据 库 支 持 读 写 分 离 ， 那 么 还 可 以 指定 数据 库 的 读 写 属性 ， 例 如 
mysql::read ° 


创建 新 的 数据 库 连 接 对 象 


当 框 架 从 未 连接 过 当前 数据 库 的 时 候 ， 就 要 对 数据 库 进 行 连接 操作 ， 首 先 程序 会 调 


用 makeConnection 2: 


makeConnection zx 





protected function makeConnection($name) 


( 


$config = $this->configuration($name) ; 


if (isset($this->extensions[$name])) { 
return call_user_func($this->extensions[$name], $config, 
$name); 


} 


if (isset($this->extensions[$driver = $config['driver']])) { 
return call_user_func($this->extensions[$driver], $confi 
g, $name); 


} 


return $this->factory->make($config, $name); 


可 以 看 出 ， 连 接 数据 库 仅 仅 需 要 两 个 步骤 : 获取 数据 库 配 置 、 利 用 connection 


factory 获取 connection He 
获取 数据 库 配置 : 


protected function configuration($name) 


1 
$name = $name ?: $this-»getDefaultConnection(); 
$connections = $this->app['config']['database.connections']; 
if (is_null($config = Arr::get($connections, $name))) ( 


throw new InvalidArgumentException("Database [$name] not 
configured."); 


j 


return $config; 


也 是 非常 简单 ， 直 接 从 配置 文件 中 获取 当前 数据 库 的 配置 : 


"connections! => [ 
'mysgl' => [ 
'driver' => 'mysql', 
'"host' => env('DB-HOST', 127 0 0 12), 
'port' => env('DB_PORT', '3306'), 
'database' => env('DB_DATABASE', 'forge'), 
'username' => env('DB_USERNAME', 'forge'), 
'password' => env('DB_PASSWORD', ''), 
'charset' => 'utf8mb4', 
'collation' => 'utf8mb4_unicode_ci', 
'prefix' => '', 
'strict' => true, 
'engine' => null, 
'read' => [ 
'database' => env('DB DATABASE', 'forge'), 
] 
'write' => [ 
'database' => env('DB DATABASE', 'forge'), 
], 
], 
], 


$this->factory->make($config, $name) 函数 向 我 们 提供 了 数据 库 连 接 对 
象 o 


configure 一 一 连接 对 象 读 写 配 置 


当 我 们 从 connection factory 中 获取 到 连接 对 象 connection 之 后 ， 我 们 就 
要 根据 传 入 的 参数 进行 读 写 配置 : 


protected function configure(Connection $connection, $type) 


{ 


$connection = $this->setPdoForType($connection, $type); 


if ($this->app->bound('events')) ( 
$connection-»setEventDispatcher($this-»app['events']); 


$connection->setReconnector(function ($connection) { 
$this->reconnect ($connection->getName()); 


3): 


return $connection; 


setPdoForType 有 函数 就 是 根据 type 来 设置 读 写 : 
当 我 们 需要 read 数据 库 连 接 时 ， 我 们 将 read-pdo 设置 为 主 pdo 。 当 我 们 
需要 write 数据 库 连 接 时 ， 我 们 将 读 写 pdo 都 设置 为 write-pdo 


protected function setPdoForType(Connection $connection, $type = 
null) 


{ 
if ($type == 'read') { 
$connection->setPdo($connection->getReadPdo()); 
} elseif ($type == 'write') ( 
$connection->setReadPdo($connection->getPdo()); 
} 
return $connection; 
} 


ConnectionFactory 一 一 数据 库 连 接 对 象 工厂 


Laravel Database 数据 库 服务 的 启动 与 连接 


ConnectionFactory:: 
make() 


parseConfig() 


tWriteConfi 


createReadWrite 
Connection() getReadWrit 
eConfig 
getWriteConfig() 


$config[‘write’] 
[array rand($config['write'])] 


mergeReadWrit 
eConfig() 


createPdoResolver 


N 
createSingleConnection() 


createReadWrit createReadPdo 


eConnection() 


getReadConfig() 
createReadPdo 
setReadPdo createPdoResolver() 





make ZZ -———r/ #0 


获取 到 了 数据 库 的 配置 参数 之 后 ， 就 要 利用 ConnectionFactory 来 获取 


connection 对 象 了 : 


public function make(array $config, $name = null) 


{ 
$config = $this->parseConfig($config, $name); 
if (isset($config['read'])) { 
return $this->createReadwriteConnection($config); 
} 
return $this->createSingleConnection($config); 
} 
protected function parseConfig(array $config, $name) 
{ 
return Arr::add(Arr::add($config, 'prefix', ''), 'name', $na 
me); 
} 
在 建立 连接 之 前 ， 要 先 向 配置 参数 中 添加 默认 的 prefix 属性 与 name 属性 。 


接着 ， 就 要 判断 我 们 在 配置 文件 中 是 否 设置 了 读 写 分 离 。 如 果 设 置 了 读 写 分 离 ， 那 
么 就 会 调用 createReadwriteConnection 函数 ， 生 成 具有 读 、 写 两 个 功能 的 
connection ; 否则 的 话 ， 就 会 调用 createSingleConnection 函数 ， 生 成 普 
的 连接 对 象 。 


SE: 


createSingleConnection 4 


Z 


createSingleConnection 函数 是 类 ConnectionFactory 的 核心 ， 用 于 生成 
新 的 数据 库 连 接 对 象 。 





j 造 数据 库 连 接 对 





protected function createSingleConnection(array $config) 


{ 


$pdo = $this->createPdoResolver($config); 


return $this->createConnection( 
$config['driver'], $pdo, $config['database'], $config['p 
refix'], $config 


): 


ConnectionFactory 也 很 简单 ， 只 做 了 两 件 事情 : 制造 pdo 连接 的 闭 包 遂 
数 、 构 造 一 个 新 的 connection 对 象 。 





createPdoResolver Re 4E Je EGE A OL HAR 


根据 配置 参数 中 是 否 含 有 host ， 创 建 不 同 的 闭 包 函数 : 


protected function createPdoResolver(array $config) 


{ 
return array_key_exists('host', $config) 
? $this->createPdoResolverWithHosts($con 
fig) 
: $this->createPdoResolverWithoutHosts($ 
config); 


} 


TUA host 的 pdo 闭 包 函数 : 


protected function createPdoResolverwithoutHosts(array $config) 


{ 


return function () use ($config) { 
return $this-»createConnector($config)-»connect($config) 


}; 


可 以 看 出 ， 不 带 有 pdo 的 闭 包 元 数 非 常 简单 ， 仅 仅 创 建 connector WH? Fi 
用 connector 对 象 进 行 数 据 库 的 连接 。 


$A host 的 pdo 闭 包 函数 : 


protected function createPdoResolverWithHosts(array $config) 
{ 
return function () use ($config) { 
foreach (Arr::shuffle($hosts = $this->parseHosts($config 
)) as $key => $host) { 
$config[ 'host'] = $host; 


try 4 
return $this->createConnector ($config) ->connect ( 


$config); 
) catch (PDOException $e) ( 
if (count($hosts) - 1 === $key && $this->contain 
er->bound(ExceptionHandler::class)) { 
$this->container ->make(ExceptionHandler::cla 
ss)->report($e); 


} 


throw $e; 


Hh 


protected function parseHosts(array $config) 


{ 
$hosts = array_wrap($config['host']); 


if (empty($hosts)) { 
throw new InvalidArgumentException('Database hosts array 
is empty.'); 
} 


return $hosts; 


带 有 host 的 闭 包 函数 相对 比较 复杂 ， 首 先 程序 会 随机 选择 不 同 的 数据 库 依 次 来 
建立 数据 库 连 接 ， 若 均 失败 ， 就 会 报告 异常 。 


ve 


createConnector 一 一 创建 连接 器 


程序 会 根据 配置 参数 中 driver 的 不 同 来 创建 不 同 的 连接 器 ， 每 个 连接 器 都 继承 
自 connector 类 ， 用 于 连接 数据 库 。 


public function createConnector(array $config) 
{ 
if (! isset($config['driver'])) { 
throw new InvalidArgumentException('A driver must be spe 
cified 1); 


} 


if ($this->container->bound($key = "db.connector.{$config['d 


river? I) t 


return $this->container ->make($key); 


switch ($config['driver']) { 

case 'mysql': 

return new MySqlConnector; 
case 'pgsql': 

return new PostgresConnector; 
case 'sqlite': 

return new SQLiteConnector; 
pase Sqlsrv': 

return new SqlServerConnector; 


throw new InvalidArgumentException("Unsupported driver [{$co 
nfig| driver |} 1"); 
} 


createConnection———4| # # #4 &% 


protected function createConnection($driver, $connection, $datab 
ase, $prefix = '', array $config = []) 
{ 
if ($resolver = Connection: :getResolver($driver)) { 
return $resolver($connection, $database, $prefix, $confi 
g); 


switch ($driver) { 
case 'mysql': 
return new MySqlConnection($connection, $database, $ 
prefix, $config); 
case 'pgsql': 
return new PostgresConnection($connection, $database 
, $prefix, $config); 
case 'sqlite': 
return new SQLiteConnection($connection, $database, 
$prefix, $config); 
case 'sqlsrv': 
return new SqlServerConnection($connection, $databas 
e, $prefix, $config); 
} 


throw new InvalidArgumentException("Unsupported driver [$dri 
ver]"); 


} 


创建 pdo 闭 包 函数 之 后 ， a 该 闭 包 函数 放 入 connection 对 象 当 中 去 。 以 后 
我 们 利用 connection 对 象 进 行 查询 或 者 更 新 数据 库 时 ， 程 序 便 会 运行 该 闭 包 函 
数 ， 与 数据 库 进行 连接 。 


createReadWriteConnection- 创建 读 写 连 接 对 象 


当 配 置 文件 中 有 read ^ write 等 配置 项 时 ， 说 明 用 户 希 望 创 建 一 个 可 以 读 写 
分 离 的 数据 库 连 接 ， 此 时 : 


protected function createReadwriteConnection(array $config) 


{ 
$connection = $this->createSingleConnection($this->getwritec 
onfig($config)); 


return $connection->setReadPdo($this->createReadPdo($config) 


); 


} 
protected function getwriteConfig(array $config) 
{ 
return $this->mergeReadwriteConfig( 
$config, $this->getReadwriteConfig($config, 'write') 
); 
} 


protected function getReadWriteConfig(array $config, $type) 


{ 
return isset($config[$type][0]) 


? $config[S$type][array. rand($config[$type])] 
: $config[$type]; 


protected function mergeReadWriteConfig(array $config, array $me 
rge) 
{ 

return Arr::except(array_merge($config, $merge), ['read', 'w 
rite']); 


j 


可 以 看 出 ， 程 序 先 读 出 关于 write 数据 库 的 配置 ， 之 后 将 其 合并 到 总 配置 当中 ， 
删除 关于 read 数据 库 的 配置 ， 然 后 进行 createsingleConnection 建立 新 的 
连接 对 象 。 


连接 对 象 之 后 ， 再 根据 read PARE ， 生 成 read 数据库 的 pdo 
E 


建立 
闭 包 函数 ， 并 调用 setReadPdo 将 其 设置 为 读 库 pdo ° 


protected function createReadPdo(array $config) 


{ 

return $this->createPdoResolver($this->getReadConfig($config 
)); 
} 
protected function getReadConfig(array $config) 
{ 

return $this->mergeReadwriteConfig( 

$config, $this->getReadwriteConfig($config, 'read') 

); 

} 


connector 连接 


我 们 以 mysql 为 例 : 


class MySqlConnector extends Connector implements ConnectorInter 
face 


{ 


public function connect(array $config) 
{ 
$dsn = $this->getDsn($config); 


$options = $this->getOptions($config); 


$connection = $this->createConnection($dsn, $config, $op 
tions); 


if (! empty($config['database'])) { 

$connection->exec("use ~“{$config['database']}°;"); 
$this->configureEncoding($connection, $config); 
$this->configureTimezone($connection, $config); 

$this->setModes($connection, $config); 


return $connection; 


getDsn 一 一 获取 数据 库 连接 DSN 参 数 


protected function getDsn(array $config) 


{ 
return $this->hasSocket($config) 
? $this-»getSocketDsn($config) 
: $this->getHostDsn($config); 
} 


protected function hasSocket(array $config) 


{ 


return isset($config['unix socket']) && ! empty($config['uni 
x socket']); 


j 


protected function getSocketDsn(array $config) 


( 


return "mysgql:unix_socket={$config[ 'unix_socket ']};dbname={$ 
config[ 'database']}"; 


j 


protected function getHostDsn(array $config) 


t 
extract($config, EXTR SKIP); 


return isset($port) 
? "mysql:host={$host}; port={$port}; dbname-($data 
base)" 
"mysql:host-($host);dbname-($database)"; 


mysql 数据 库 的 连接 有 两 种 : tcp 连 接 与 socket 连接 。 


socket 连接 更 快 ， 但 是 它 要 求 应 用 程序 与 数据 库 在 同一 台 机 器 ， 更 普通 的 是 使 
用 tcp 的 方式 连接 数据 库 。 框 架 根据 配置 参数 来 选择 是 采用 socket 还 是 
tcp 的 方式 连接 数据 库 。 


getOptions——pdo 属性 设置 


protected $options = [ 
PDO::ATTR CASE => PDO::CASE NATURAL, 
PDO::ATTR ERRMODE -» PDO::ERRMODE EXCEPTION, 
PDO::ATTR ORACLE NULLS -» PDO::NULL NATURAL, 
PDO::ATTR STRINGIFY FETCHES -» false, 
PDO::ATTR EMULATE PREPARES => false, 


l; 


public function getOptions(array $config) 


{ 
$options = Arr::get($config, 'options', []); 


return array_diff_key($this->options, $options) + $options; 


pdo 的 属性 主要 有 以 下 几 种 : 


e PDO::ATTR_CASE 强制 列 名 为 指定 的 大 小 写 。 他 的 $value 可 为 : 
o PDO::CASE_LOWER : 强制 列 名 小 写 。 
o PDO::CASE NATURAL : 保留 数据 库 驱 动 返回 的 列 名 。 
o PDO::CASE_UPPER : 强制 列 名 大 写 。 
e PDO::ATTR_ERRMODE : 错误 报告 。 他 的 $value 可 为 : 
o PDO::ERRMODE_SILENT : 仅 设 置 错误 代码 。 
o PDO::ERRMODE_WARNING : 引发 E WARNING 错误 . 
o PDO::ERRMODE_EXCEPTION : 抛 出 exceptions +% ° 
e PDO::ATTR ORACLE NULLS (在 所 有 驱动 中 都 可 用 ， 不 仅 限于 Oracle) : & 
4% NULL 和 空 字符 串 。 他 的 $value 可 为 : 
o PDO::NULL_NATURAL : 不 转换 。 
o PDO::NULL_EMPTY_STRING : 将 空 字符 串 转换 成 NULL ° 
o PDO::NULL_TO_STRING : 将 NULL 转换 成 空 字符 串 。 
e PDO::ATTR_STRINGIFY_FETCHES : 提取 的 时 候 将 数值 转换 为 字符 串 。 
e  PDO::ATTR EMULATE PREPARES 启用 或 禁用 预 处 理 语句 的 模拟 。 有 些 驱 动 
不 支持 或 有 限度 地 支持 本 地 预 处 理 。 使 用 此 设置 强制 PDO 总 是 模拟 预 处 理 语句 
(如 果 为 TRUE ) ， 或 试 着 使 用 本 地 预 处 理 语句 (如果 为 FALSE ) 。 如 果 
驱动 不 能 成 功 预 处 理 当 前 查询 ， 它 将 总 是 回 到 模拟 预 处 理 语句 上 。 需要 
bool 类 型 。 
e PDO::ATTR_AUTOCOMMIT :设置 当前 连接 Mysql 服务 器 的 客户 端的 SQL 语 


多 是 否 自动 执行 ， 默 认 是 自动 提交 ， 
èe PDO::ATTR_PERSISTENT : 当前 对 Mysql 服 务 器 的 连接 是 否 是 长 连接 . 


createConnection——— 4 # Zt 4E JÆ 3& 4} 


public function createConnection($dsn, array $config, array $opt 
ions) 
1 
list($username, $password) = [ 
Arr::get($config, 'username'), Arr::get($config, 'passwo 
rd 
l; 


try { 
return $this->createPdoConnection( 


$dsn, $username, $password, $options 
); 
) catch (Exception $e) ( 
return $this->tryAgainIfCausedByLostConnection( 
$e, $dsn, $username, $password, $options 


); 


protected function createPdoConnection($dsn, $username, $passwor 
d, $options) 
if (class_exists(PDOConnection::class) && ! $this->isPersist 
entConnection($options)) { 
return new PDOConnection($dsn, $username, $password, $op 
tions); 


} 


return new PDO($dsn, $username, $password, $options); 


4 pdo 对 象 成 功 的 建立 起 来 后 ， 说 明 我 们 已 经 与 数据 库 成 功 地 建立 起 来 了 一 个 连 
接 ， 接 下 来 我 们 就 可 以 利用 这 个 pdo 对 象 进行 查询 或 者 更 新 等 操作 。 


当 创 建 pdo 的 时 候 抛 出 异常 时 


protected function tryAgainIfCausedByLostConnection(Exception $e 
, $dsn, $username, $password, $options) 
{ 
if ($this->causedByLostConnection($e)) { 
return $this->createPdoConnection($dsn, $username, $pass 
word, $options); 


} 


throw $e; 


protected function causedByLostConnection(Exception $e) 


{ 


$message = $e->getMessage(); 


return Str::contains($message, [ 
"server has gone away', 
'no connection to the server', 
"Lost connection', 
'is dead or not enabled', 
'Error while sending', 
'decryption failed or bad record mac', 
'server closed the connection unexpectedly', 
'SSL connection has been closed unexpectedly', 
'Error writing data to the connection', 
'Resource deadlock avoided', 


] ) 


当 判 断 出 的 异常 是 上 面 几 种 情况 时 ， 框 架 会 再 次 尝试 连接 数据 库 。 


configureEncoding 一 一 设置 字符 集 与 校对 集 





protected function configureEncoding($connection, array $config) 


{ 
if (! isset($config['charset'])) { 
return $connection; 


$connection ->prepare( 
"set names '{$config[ 'charset']}'".$this->getCollation($ 
config) 
)-»execute( ); 


protected function getCollation(array $config) 


{ 
return ! is_null($config['collation']) ? " collate '{$config 
[cod autdoncp a or 


} 


如 果 配 置 参 数 中 设置 了 字符 集 与 校对 集 ， 程 序 会 利用 配置 的 参数 对 数据 库 进行 相关 


设置 o 


所 谓 的 字符 集 与 校对 集 设 置 ， 可 以 参考 mysql 中 character set 5 collation 的 点 滴 
理解 





configureTimezone 设置 时 间 区 


protected function configureTimezone($connection, array $config) 


{ 
if (isset($config['timezone'])) { 
$connection->prepare('set time_zone="'.$config['timezone' 
].'"')->execute(); 
} 
} 


is] = - m] 


<i SQL MODE € X 





protected function setModes(PDO $connection, array $config) 


{ 
if (isset($config['modes'])) { 


$this->setCustomModes($connection, $config); 
} elseif (X3sset($config['strict'])) { 
if ($config[ strict ]) { 
$connection->prepare($this->strictMode())->execute() 


} else { 
$connection->prepare("set session sql_mode='NO_ENGIN 
E SUBSTITUTION'")-»execute( ); 


j 


protected function setCustomModes(PDO $connection, array $config) 


$modes - implode(',', $config['modes']); 


$connection->prepare("set session sql_mode='{$modes}'")->exe 
cute(); 


} 


protected function strictMode() 


{ 
return "set session sql_mode='ONLY_FULL_GROUP_BY, STRICT_TRAN 


S TABLES, NO ZERO IN DATE, NO ZERO DATE, ERROR FOR DIVISION BY ZERO 
,NO AUTO CREATE USER, NO ENGINE SUBSTITUTION'"; 


} 
国 杆 == 站 汉 
以 下 内 容 参 考 : mysql 的 sql|_ mode 设 置 简介 : 


SQL MODE 直接 理解 就 是 : sq| 的 运作 模式 。 官 方 的 说 法 是 : sql_mode 可 以 影响 
sq 支持 的 语法 以 及 数据 的 校 验 执行 ， 这 使 得 MySQL 可 以 运行 在 不 同 的 环境 中 以 及 
和 其 他 数据 库 一 起 运作 。 


想 设 置 sSq| mode 有 三 种 方式 : 


在 命令 行 启动 MySQL 时 添加 参数 --sql-mode="modes" 
在 MySQL 的 配置 文件 (my.cnf 或 者 my.ini) 中 添加 一 个 配置 sql-mode="modes" 
运行 时 修改 SQL mode 可 以 通过 以 下 命令 之 一 : 


SET GLOBAL sql mode = 'modes'; 
SET SESSION sql mode - 'modes'; 


几 种 常见 的 mode 介 绍 


ONLY FULL GROUP BY : 出 现在 select i$4]^ HAVING 条 件 和 ORDER 
BY ia Pays] > x28 3X GROUP BY 的 列 或 者 依赖 于 GROUP BY 列 的 函数 
列 o 


NO AUTO VALUE ON ZERO : 该 值 影响 自 增 长 列 的 插入 。 黑 认 设 置 下 ， 插 入 0 
或 NULL 代表 生成 下 一 个 自 增 长 值 。 如 果 用 户 希望 插入 的 值 为 0， 而 该 列 又 
是 自 增长 的 ， 那 么 这 个 选项 就 有 用 了 。 

STRICT TRANS TABLES : 在 该 模式 下 ， 如 果 一 个 值 不 能 插入 到 一 个 事务 表 
中 ， 则 中 断 当 前 的 操作 ， 对 非 事务 表 不 做 限制 


NO ZERO IN DATE : 这 个 模式 影响 了 是 否 允 许 日 期 中 的 月 份 和 日 包含 0。 如 
果 开 启 此 模式 ，2016-01-00 是 不 允许 的 ， 但 是 0000-02-01 是 允许 的 。 它 实际 的 
行为 受到 strict mode 是 否 开 启 的 影响 1。 


NO ZERO DATE : 设置 该 值 ， mysql 数据 库 不 允许 插入 零 日 期 。 它 实际 的 
行为 受到 strict mode 是 否 开局 的 影响 2。 


ERROR FOR DIVISION BY ZERO : 在 INSERT 或 UPDATE 过 程 中 ， 如 果 
数据 被 需 除 ， 则 产生 错误 而 非 警 告 。 如 果 未 给 出 该 模式 ， 那 么 数据 被 零 除 时 
MySQL 返回 NULL 


NO AUTO CREATE USER : 禁止 GRANT 创建 密码 为 空 的 用 户 


NO ENGINE SUBSTITUTION : 如 果 需 要 的 存储 引擎 被 禁用 或 未 编译 ， 那 么 抛 
出 错误 。 不 设置 此 值 时 ， 用 默认 的 存储 引擎 替代 ， 并 抛 出 一 个 异常 
PIPES AS CONCAT : 将 ?||" 视 为 字符 串 的 连接 操作 符 而 非 或 运算 符 ， 这 和 
Oracle 数 据 库 是 一 样 的 ， 也 和 字符 囊 的 拼接 函数 Concat 相 类 似 


e ANSI QUOTES : 启用 ANSI QUOTES 后 ， 不 能 用 双 引 号 来 引用 字符 串 ， 
为 它 被 解释 为 识别 符 


3 connection 对 象 构 建 初始 化 完成 后 ， 我 们 就 可 以 利用 DB 来 进行 数据 库 的 
CRUD ( Create ^ Retrieve ^ Update ^ Delete ) 操 作 。 本 篇 文章 ， 我 们 
将 会 讲述 laravel 如 何 与 pdo 交互 ， 实 现 基 本 数据 库 服务 的 原理 。 


run 


laravel 中 任何 数据 库 的 操作 都 要 经 过 run 这 个 函数 ， 这 个 函数 作用 在 于 重新 
连接 数据 库 、 记 录 数 据 库 日 志 、 数 据 库 开 常 处 理 : 


protected function run($query, $bindings, Closure $callback) 
{ 


$this->reconnectIfMissingConnection(); 
$start = microtime(true); 


try f 


$result = $this->runQueryCallback($query, $bindings, $ca 
llback); 


) catch (QueryException $e) ( 
$result = $this->handleQueryException( 
$e, $query, $bindings, $callback 
); 


$this->logQuery( 
$query, $bindings, $this->getElapsedTime($start ) 
); 


return $result; 


重新 连接 数据 库 reconnect 


如 果 当 期 的 pdo 是 空 ， 那 么 就 会 调用 reconnector 重新 与 数据 库 进行 连接 : 


protected function reconnectIfMissingConnection() 


1 
if (is null($this-»2pdo)) { 
$this-»reconnect(); 


public function reconnect() 


{ 
if (is_callable($this->reconnector)) { 
return call_user_func($this->reconnector, $this); 


throw new LogicException('Lost connection and no reconnector 
available.'); 


} 
运行 数据 库 操作 


数据 库 的 curd 操作 会 被 包装 成 为 一 个 闭 包 函数 ， 作 为 runQueryCallback 的 一 
个 参数 ， 当 运行 正常 时 ， 会 返回 结果 ， 如 果 遇 到 异常 的 话 ， 会 将 异常 转化 为 
QueryException ， 并 且 抛 出 。 


protected function runQueryCallback($query, $bindings, Closure $ 
callback) 


1 
EM si 
$result = $callback($query, $bindings); 
J 
catch (Exception $e) ( 
throw new QueryException( 
$query, $this->prepareBindings($bindings), $e 
); 
J 
return $result; 
} 
X 已 党 
数据 库 异 第 处 理 


3 pdo 查询 返回 异常 的 时 候 ， 如 果 当 前 是 事务 进行 时 ， 那 么 直接 返回 异常 ， 让 上 
一 层 事务 来 处 理 。 


如 果 是 由 于 与 数据 库 事情 连接 导致 的 异常 ， 那 么 就 要 重新 与 数据 库 进 行 连接 : 


protected function handleQueryException($e, $query, $bindings, C 
losure $callback) 


{ 
if ($this->transactions >= 1) { 
throw $e; 
} 
return $this->tryAgainIfCausedByLostConnection( 
$e, $query, $bindings, $callback 
); 
} 


与 数据 库 失 去 连接 : 
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protected function tryAgainIfCausedByLostConnection(QueryExcepti 
on $e, $query, $bindings, Closure $callback) 


1 
if ($this->causedByLostConnection($e->getPrevious())) { 
$this->reconnect(); 
return $this->runQueryCallback($query, $bindings, $callb 
ack); 
} 
throw $e; 
} 


protected function causedByLostConnection(Exception $e) 


{ 


$message = $e->getMessage(); 


return Str::contains($message, [ 
"server has gone away', 
'no connection to the server', 
"Lost connection', 
'is dead or not enabled', 
‘Error while sending’, 
‘decryption failed or bad record mac', 
"server closed the connection unexpectedly', 
'SSL connection has been closed unexpectedly', 
'Error writing data to the connection', 
'Resource deadlock avoided', 
'Transaction() on null’, 
'child connection forced to terminate due to client_idle 


数据 库 日 志 


368 


public function logQuery($query, $bindings, $time = null) 
1 

$this->event(new QueryExecuted($query, $bindings, $time, $th 
is)); 


if ($this->loggingQueries) { 
$this->queryLog[] = compact('query', 'bindings', 'time') 


想 要 开局 或 关闭 日 志 功 能 : 


public function enableQueryLog() 


{ 

$this->loggingQueries = true; 
} 
public function disableQueryLog( ) 
{ 

$this->loggingQueries = false; 
} 


Select 查询 


public function select($query, $bindings = [], $useReadPdo = tru 
e) 
{ 
return $this->run($query, $bindings, function ($query, $bind 
ings) use ($useReadPdo) { 
if ($this->pretending()) { 
return []; 


$statement = $this->prepared($this->getPdoForSelect($use 
ReadPdo) 
-»prepare($query)); 


$this->bindValues($statement, $this->prepareBindings($bi 
ndings) ); 


$statement ->execute(); 


return $statement->fetchAll(); 
3); 


数据 库 的 查询 主要 有 一 下 几 个 步骤 : 


e 获取 $this->pdo 成 员 变量 ， 若 当前 未 连接 数据 库 ， 则 进行 数据 库 连 接 ， 获 
取 pdo HŽ ° 

e 设置 pdo 数据 fetch 模式 

e pdo 进行 sql 语句 预 处 理 ，pdo 绑 定 参数 

e sql 语句 执行 ， 并 获取 数据 。 


getPdoForSelect 获取 pdo FR 


protected function getPdoForSelect($useReadPdo = true) 


{ 
return $useReadPdo ? $this->getReadPdo() : $this->getPdo(); 


} 
public function getPdo() 
{ 
if ($this->pdo instanceof Closure) { 
return $this->pdo = call_user_func($this->pdo); 
} 
return $this->pdo; 
} 
public function getReadPdo() 
{ 
if ($this->transactions > 0) { 
return $this->getPdo(); 
} 
if ($this->getConfig('sticky') && $this->recordsModified) { 
return $this->getPdo(); 
} 
if ($this->readPdo instanceof Closure) { 
return $this->readPdo = call_user_func($this->readPdo) ; 
} 
return $this->readPdo ?: $this->getPdo(); 
} 


getPdo 这 里 逻辑 比较 简单 ， 值 得 我 们 注意 的 是 getReadPdo 。 为 了 减缓 数据 库 
的 压力 ， 我 们 常常 对 数据 库 进行 读 写 分 离 ， 也 就 是 只 要 当 写 数据 库 这 种 操作 发 生 


时 ， 才 会 使 用 写 数 据 库 ， 否 则 都 会 用 读数 据 库 。 这 种 措施 减少 了 数据 库 的 压力 ， 但 
是 也 带 来 了 一 些 问 题 ， 那 就 是 读 写 两 个 数据 库 在 一 定时 间 内 会 出 现 数据 不 一 致 的 情 
况 ， 原 因 就 是 写 库 的 数据 未 能 及 时 推送 给 读 库 ， 造 成 读 库 数据 延迟 的 现象 。 为 了 在 


一 定 程 度 上 解决 这 类 问题 ， laravel 增添 了 sticky 选项 ， 


从 程序 中 我 们 可 以 看 出 ， 当 我 们 设置 选项 sticky AB > H Eaa x BER UT 
了 写 操 作 后 ， getReadPdo 会 强制 返回 主 库 的 连接 ， 这 样 就 避免 了 读 写 分 离 造成 
的 延迟 问题 e 


还 有 一 种 情况 ， 当 数据 库 在 执行 事务 期 间 ， 所 有 的 读 取 操 作 也 会 被 强制 连接 主 库 。 
prepared 设置 数据 获取 方式 


protected $fetchMode = PDO: :FETCH_OBJ; 
protected function prepared(PDOStatement $statement ) 


{ 
$statement->setFetchMode($this->fetchMode) ; 


$this->event(new Events\StatementPrepared( 
$this, $statement 
)); 


return $statement; 


pdo 的 setFetchMode 函数 用 于 为 语句 设置 默认 的 获取 模式 ， 通 常 模式 有 一 下 
几 种 : 


e PDO::FETCH_ASSOC /从 结果 集中 获取 以 列 名 为 索引 的 关联 数组 。 

e PDO:FETCH NUM /从 结果 集中 获取 一 个 以 列 在 行 中 的 数值 偏 移 量 为 索引 的 
值 数 组 。 

e。PDO::FETCH_BOTH // 这 是 默认 值 ， 包 含 上 面 两 种 数组 。 

e PDO::FETCH_OBJ /从 结果 集 当 前 行 的 记录 中 获取 其 属性 对 应 各 个 列 名 的 一 个 
xpo 

e PDO:FETCH BOUND // 使 用 fetch() 返 回 TRUE， 并 将 获取 的 列 值 赋 给 在 
bindParm() 方 法 中 指定 的 相应 变量 。 

e PDO::FETCH_LAZY /创建 关联 数组 和 索引 数组 ， 以 及 包含 列 属 性 的 一 个 对 
象 ， 从 而 可 以 在 这 三 种 接口 中 任 选 一 种 。 


pdo 的 prepare 函数 


prepare WAZA PDOStatement::execute() 方法 准备 要 执行 的 SQL 语 
4^ SQL 语句 可 以 包含 零 个 或 多 个 命名 ( :name ) 或 问号 ( ? ) 参数 标记 ， 参 
数 在 SQL 执行 时 会 被 替换 。 

能 在 SQL 语句 中 同时 包含 命名 ( :name ) 或 问号 ( ? ) 参数 标记 ， 只 能 选 
h 种 风格 。 
WAH SQL 语句 中 的 参数 在 使 用 PDOStatement::execute() 方法 时 会 传递 提 
实 的 参数 。 
之 所 以 使 用 prepare 函数 ， 是 因为 这 个 函数 可 以 防止 SQL 注入 ， 并 且 可 以 加 
快 同一 查询 语句 的 速度 。 关 于 预 处 理 与 参数 绑 定 防止 SQL 漏洞 注入 的 原理 可 以 参 
考 : Web 安 全 之 SQL 注入 攻击 技巧 与 防范 . 


pdo 的 bindValues & 4 


在 调用 pdo 的 参数 绑 定 函数 之 前 ， laravel 对 参数 值 进一步 进行 了 优化 ， 把 时 
间 类 型 的 对 象 利 用 grammer 的 设置 重新 格式 化 ， false 也 改 为 0。 


pdo 的 参数 绑 定 函数 bindvalue ， 对 于 使 用 命名 占 位 符 的 预 处 理 语句 ， 应 是 类 
44. name 形式 的 参数 名 。 对 于 使 用 问号 占 位 符 的 预 处 理 语 名 ， 应 是 以 1 开始 索引 的 
参数 位 置 。 


public function prepareBindings(array $bindings) 


{ 
$grammar = $this-»getQueryGrammar(); 
foreach ($bindings as $key => $value) { 
if ($value instanceof DateTimeInterface) ( 
$bindings[$key] = $value->format($grammar ->getDateFo 
rmat()); 
} elseif ($value === false) ( 
$bindings[$key] = 0; 
} 
} 
return $bindings; 
y 


public function bindValues($statement, $bindings) 
{ 
foreach ($bindings as $key => $value) { 
$statement ->bindValue( 
is_string($key) ? $key : $key + 1, $value, 
is_int($value) ? PDO::PARAM_INT : PDO::PARAM_STR 
); 


public function insert($query, $bindings = []) 
1 


return $this->statement($query, $bindings); 


public function statement($query, $bindings = []) 
{ 


return $this->run($query, $bindings, function ($query, $bind 


Ings) ot 
if ($this->pretending()) { 
return true; 


$statement = $this->getPdo()->prepare($query) ; 


$this->bindValues($statement, $this->prepareBindings($bi 
ndings) ); 


$this->recordsHaveBeenModified(); 


return $statement->execute(); 


3); 


这 部 分 的 代码 与 select 非常 相似 ， 不 同 之 处 有 一 下 几 个 : 


e 直接 获取 写 库 的 连接 ， 不 会 考虑 读 库 

e 由 于 不 需要 返回 任何 数据 库 数据 ， 因 此 也 不 必 设 置 fetchMode ° 
e recordsHaveBeenModified 函数 标志 当前 连接 数据 库 已 被 写 入 。 
e 不 需要 调用 函数 fetchAll 


public function recordsHaveBeenModified($value = true) 


1 
if (! $this->recordsModified) { 
$this->recordsModified = $value; 


update ` delete 


affectingStatement 这 个 函数 与 上 面 的 statement 函数 一 致 ， 只 是 最 后 会 


回 更 新 、 删 除 影 响 的 行 数 。 


public function update($query, $bindings = []) 


{ 
return $this->affectingStatement($query, $bindings); 


public function delete($query, $bindings = []) 


{ 
return $this->affectingStatement($query, $bindings); 


} 
public function affectingStatement($query, $bindings = []) 
{ 
return $this->run($query, $bindings, function ($query, $bind 

ings) { 

if ($this->pretending()) { 

rScUlici (8)7 

} 

$statement = $this-»getPdo()-»prepare($query); 

$this->bindValues($statement, $this->prepareBindings($bi 
ndings)); 


$statement ->execute(); 


$this->recordsHaveBeenModified( 
($count = $statement->rowCount()) > 9 


); 


return $count; 


3): 


iR 


transaction 数据 库 事务 


为 保持 数据 的 一 致 性 ， 对 于 重要 的 数据 我 们 经 常 使 用 数据 库 事 务 ， transaction 
函数 接受 一 个 闭 包 函数， 与 一 个 重复 党 试 的 次 数 : 


public function transaction(Closure $callback, $attempts = 1) 
{ 
for ($currentAttempt = 1; $currentAttempt <= $attempts; $cur 
rentAttempt++) { 
$this->beginTransaction(); 


try A 
return tap($callback($this), function ($result) { 


$this->commit(); 


3): 


catch (Exception $e) ( 
$this->handleTransactionException( 
$e, $currentAttempt, $attempts 
); 
) catch (Throwable $e) ( 
$this->rollBack(); 


throw $e; 


开始 事务 


数据 库 事务 中 非常 重要 的 成 员 变 量 是 $this->transactions ， 它 标志 着 当前 事 
务 的 进程 : 


public function beginTransaction( ) 


{ 
$this->createTransaction(); 
++$this->transactions; 
$this->fireConnectionEvent('beganTransaction' ); 
} 


am 
过 


可 以 看 出 ， 当 创建 事务 成 功 后 ， 就 会 累加 $this->transactions ， 并 且 
event ， 创 建 事 务 : 


protected function createTransaction() 


{ 
if ($this->transactions == 0) { 
try { 
$this->getPdo()->beginTransaction(); 
} catch (Exception $e) { 
$this->handleBeginTransactionException($e); 


} 


} elseif ($this->transactions >= 1 && $this->queryGrammar ->s 
upportsSavepoints()) { 
$this->createSavepoint(); 


如 果 当 前 没有 任何 事务 ， 那 么 就 会 调用 pdo 来 开局 事务 。 


如 果 当 前 已 经 在 事务 保护 的 范围 内 ， 那 么 就 会 创建 SAVEPOINT > ZIARA 
事务 : 


protected function createSavepoint() 


{ 
$this-»getPdo()-»exec( 
$this->queryGrammar ->compileSavepoint('trans'.($this->tr 
ansactions + 1)) 


); 


} 
public function compileSavepoint ($name) 
{ 
return 'SAVEPOINT '.$name; 
} 


如 果 创 建 事 务 失败 ， 那 么 就 会 调用 handleBeginTransactionException 


protected function handleBeginTransactionException($e) 


{ 
if ($this->causedByLostConnection($e)) ( 
$this-»reconnect(); 


$this->pdo->beginTransaction(); 


} else { 
throw $e; 


如 果 创 建 事 务 失 败 是 由 于 与 数据 库 失 去 连接 的 话 ， 那 么 就 会 重新 连接 数据 库 ， 否 则 
就 要 抛 出 异常 。 


FBR 


事务 的 异常 处 理 比 较 复杂 ， 可 以 先 看 一 看 代码 : 
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protected function handleTransactionException($e, $currentAttemp 
t, $maxAttempts) 


1 
if ($this->causedByDeadlock($e) && 
$this->transactions > 1) ( 
--$this->transactions; 
throw $e; 
} 
$this->rollBack(); 
if ($this->causedByDeadlock($e) && 
$currentAttempt < $maxAttempts) { 
return; 
} 
throw $e; 
} 
protected function causedByDeadlock(Exception $e) 
{ 
$message = $e->getMessage(); 
return Str::contains($message, [ 
"Deadlock found when trying to get lock', 
‘deadlock detected', 
'The database file is locked', 
'database is locked', 
'database table is locked', 
'A table in the database is locked', 
'has been chosen as the deadlock victim', 
"Lock wait timeout exceeded; try restarting transaction' 
1); 
} 
这 里 可 以 分 为 四 种 情况 : 


380 


e 单一 事务 ， 非 死 锁 导 致 的 异常 


单一 事务 就 是 说 ， 此 时 的 事务 只 有 一 层 ， 人 。 数 据 库 的 异常 也 不 
是 死 锁 导 致 的 ， 一 般 是 由 于 sql 语句 不 正确 引起 的 。 这 个 时 
候 ， handleTransactionException 会 直接 回 滚 事务 ， 并 且 抛 出 异常 到 外 层 : 


try { 
return tap($callback($this), function ($result) { 
$this->commit(); 
3); 
p 
catch (Exception $e) ( 
$this->handleTransactionException( 
$e, $currentAttempt, $attempts 
); 
} catch (Throwable $e) { 
$this->rollBack(); 


throw $e; 


接 到 异常 之 后 ， 程 序 会 再 次 回 滚 ， 但 是 由 于 $this-»transactions 已 经 为 0， 
因此 回 滚 直接 返回 ， 并 未 真正 执行 ， 之 后 就 会 抛 出 异常 。 


e 单一 事务 ， 死 锁 异 常 


有 死 锁 导致 的 单一 事务 异常 ， 一 般 是 由 于 其 他 程序 同时 更 改 了 数据 库 ， 这 个 时 候 ， 
就 要 判断 当前 重复 尝试 的 次 数 是 否 大 于 用 户 设置 的 maxAttempts ， 如 果 小 于 就 继 
续 党 试 ， 如 果 大 于 ， 那 么 就 会 抛 出 异常 


e ARX ? 非 死 锁 异 常 
to RW MARES F > Fil do 


NDB: : transaction(function()( 


//directly or indirectly call another transaction: 
NDB: :transaction(function() { 


}, 2);//attempt twice 
}, 2);//attempt twice 


如 果 是 非 死 锁 叶 致 的 异常 ， 那 么 就 要 首先 回 滚 内 层 的 事务 ， 抛 出 异常 到 外 层 事务 ， 
再 回 深 外 层 事务 ， 抛 出 异常 ， 让 用 户 来 处 理 。 也 就 是 说 ， 对 于 嵌 套 事务 来 说 ， 内 
事务 异常 ， 一 定 要 回 滚 整 个 事务 ， 而 不 是 仅仅 回 滚 内 部 事务 。 


* 
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滚 整个 事务 。 


但 是 ， 不 同 的 是 ，mysql 对 于 嵌 套 事务 的 回 深 会 导致 外 部 事务 一 并 回 深 :InnoDB 
Error Handling， 因 此 这 时 ， 我 们 仅仅 将 $this->transactions 减 一 ， 并 抛 出 开 
常 ， 使 得 外 层 事务 回 滚 抛 出 异常 即 可 。 


Ek SF 


如 果 事务 内 的 数据 库 更 新 操作 失败 ， 那 么 就 要 进行 回 滚 : 


public function rollBack($toLevel = null) 


{ 
$toLevel = is_null($toLevel) 


? $this->transactions - 1 
: $toLevel; 


if ($toLevel < 0 || $toLevel >= $this->transactions) { 
return; 


$this->performRollBack($toLevel); 
$this->transactions = $toLevel; 


$this->fireConnectionEvent('rollingBack'); 


回 滚 的 第 一 件 事 就 是 要 减少 $this->transactions 的 值 ， 标 志 当 前 事务 失败 。 


回 滚 的 时 候 仍 然 要 判断 当前 事务 的 状态 ， 如 果 当 前 处 于 吝 套 事务 的 话 ， 就 要 进行 回 
RZ] SAVEPOINT ， 如 果 是 单一 事务 的 话 ， 才 会 真正 回 滚 退 出 事务 : 


protected function performRollBack($toLevel) 
1 
if ($toLevel == 0) { 
$this->getPdo( )->rollBack(); 
} elseif ($this->queryGrammar ->supportsSavepoints()) { 
$this->getPdo( )->exec( 
$this->queryGrammar ->compileSavepointRollBack('trans' 
.($toLevel + 1)) 
); 


} 
} 
public function compileSavepointRollBack($name) 
{ 
return 'ROLLBACK TO SAVEPOINT '.$name; 
} 





提交 事务 


提交 事务 比较 简单 ， 仅 仅 是 调用 pdo 的 commit 即 可 。 需 要 注意 的 是 对 于 获 套 
事务 的 事务 提交 ， commit 函数 仅仅 更 新 了 $this->transactions ， 而 并 没有 
攻 正 提交 事务 ， 原 因 是 内 层 事务 的 提交 对 于 mysql 来 说 是 无 效 的 ， 只 有 外 部 事务 


的 提交 


能 更 新 整个 事务 。 


public function commit() 


( 


if ($this->transactions == 1) { 
$this->getPdo( )->commit(); 


$this->transactions = max(0, $this->transactions - 1); 


$this->fireConnectionEvent('committed'); 


paginate 分 页 


% 4x > Fe 
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laravel 的 分 页 用 起 来 非常 简单 ， 只 需要 对 query 调用 paginate 
返回 的 对 象 扔 给 前 端 blade 文件 ;在 blade 函数 render 
link 有 函数， 就 可 以 得 到 上 一 页 ` 下 一 页 等 等 分 页 特效 。 


m m 


实际 上 ， Bee 简 eae 页 服务 看 作 一 个 前 端 资 源 ， render 函数 或 者 
link HAERE 前 


J 35 AR 
如 果 你 还 对 laravel 的 分 页 不 是 很 熟悉 ， 请 先 阅读 官方 文档 : 分 页 。 
分 页 服务 的 局 元 


分 页 功能 也 是 由 一 个 服务 提供 者 所 局 动 的 ， PaginationserviceProvider 就 是 
负责 注册 和 启动 分 页 服务 的 服务 提供 者 : 


Class PaginationServiceProvider extends ServiceProvider 


{ 


public function register( ) 


{ 
Paginator::viewFactoryResolver(function () { 
return $this->app['view' ]; 


3): 


Paginator::currentPathResolver(function () { 
return $this->app['request']->url(); 


3): 


Paginator::currentPageResolver(function ($pageName - 'pa 
ge') i 
$page = $this-»app['request']-»input($pageName); 


if (filter var($page, FILTER VALIDATE INT) !-- false 
&& (int) $page >= 1) { 
return $page; 


returnas 


3): 


我 们 看 到 ， 服 务 提供 者 的 注册 函数 为 ”Paginator 设置 三 个 闭 包 函 数 : 


e viewFactoryResolver 为 Paginator 设置 了 生成 前 端 资源 的 类 ， 用 于 获取 分 
页 前端 代码 。 

e currentPathResolver 为 Paginator 设置 了 url 的 地 址 。 我 们 知道 ， 上 
一 页 、 下 一 页 等 等 都 是 可 以 执行 翻 页 的 操作 ， 所 以 实际 上 这 些 按钮 必然 含有 
链接 ， 而 链接 的 地 址 就 是 当前 请 求 的 url 地 址 ， 不 同 的 按钮 的 链接 地 址 只 是 

page 的 参数 不 同 而 已 。 

e currentPageResolver 为 Paginator 获取 了 当前 的 页 数 。 


pubie Tunetzon: boot €) 


{ 
$this->loadViewsFrom(__DIR__.'/resources/views', 'pagination' 


): 


if ($this->app->runningInConsole()) ( 
$this-»publishes([ 
. DIR .'/resources/views' => $this->app->resourcePa 
th('views/vendor/pagination'), 
], 'laravel-pagination'); 


protected function loadViewsFrom($path, $namespace) 


1 
if (is dir(S$appPath = $this->app->resourcePath().'/views/ven 
dor/'.$namespace)) { 
$this->app['view' ]->addNamespace($namespace, S$appPath); 


$this->app[ 'view' ]->addNamespace($namespace, $path); 


服务 的 启动 函数 为 分 页 服务 设置 了 默认 的 前 端 分 页 资源 。 


分 页 服务 paginator 


分 页 服务 paginator 函数 用 于 queryBuilder ， 用 于 获取 分 页 的 数据 库 数 据 : 


public function paginate($perPage = 15, $columns = ['*'], $pageN 
ame = 'page', $page = null) 


{ 
$page = $page ?: Paginator::resolveCurrentPage($pageName) ; 
$total = $this->getCountForPagination($columns) ; 
$results = $total 
? $this->forPage($page, $perPage)-»get($columns) : colle 
ct(); 
return $this->paginator($results, $total, $perPage, $page, [ 
'path' => Paginator::resolveCurrentPath(), 
'pageName' => $pageName, 
1); 
} 


protected function paginator($items, $total, $perPage, $currentP 
age, $options) 


i 


return Container: :getInstance()->makeWwith(LengthAwarePaginat 
or::class, compact( 
'items', 'total', 'perPage', 'currentPage', 'options' 


2); 


也 就 是 说 ， 当 我 们 写 下 这 样 的 代码 时 : 
DB: :table('user')->select('*')->where('status',1)->paginator(); 


我 们 可 以 获取 到 一 个 LengthAwarePaginator 类 对 象 ， 对 这 个 对 象 调用 
render 函数 就 可 以 获取 分 页 前 端 资源 。 


我 们 先 来 研究 一 下 paginator Až ° 


获取 当前 页 


我 们 可 以 看 到 ， 在 这 个 函数 中 程序 先 获 取 当 前 页 数 : 


public static function resolveCurrentPage($pageName = 'page', $d 
efault = 1) 


1 
if (isset(static::$currentPageResolver)) { 
return call user func(static::$currentPageResolver, $pag 
eName); 
} 
return $default; 
} 


currentPageResolver 就 是 上 一 节 中 currentPageResolver 设置 的 闭 包 函数 ， 
这 个 闭 包 元 数 从 请 求 参数 中 获取 当前 页 : 


$page = $this->app['request']->input($pageName); 


获取 数据 库 总 记录 数 


计算 数据 库 符 合 搜索 条 件 的 总 记录 数理 所 当然 的 是 使 用 聚合 函数 count 


public function getCountForPagination($columns = ['*']) 


{ 


$results = $this->runPaginationCountQuery($columns ); 


if (isset($this->groups)) { 
return count($results); 
} elseif (! isset($results[0])) { 
iet utm» 
) elseif (is object($results[0])) { 
return (int) $results[0]->aggregate; 
) else { 
return (int) array change key case((array) $results[0])[ 
'aggregate' ]; 
} 


protected function runPaginationCountQuery($columns = ['*']) 


{ 
return $this->clonewWithout(['columns', 'orders', 'limit', 'o 
ffset']) 
-»cloneWithoutBindings(['select', 'order']) 
-»setAggregate('count', $this->withoutSelectAlia 
ses($columns)) 
->get()->all(); 


+ py 一 二 小 

获取 当前 页 数据 

获取 当前 页 当然 是 使 用 forpage BA: 
$results = $total 


? $this->forPage($page, $perPage)-»get($columns) : colle 
ct(); 


初始 化 LengthAwarePaginator 


paginator AXA] Fi] loc 容器 来 生成 LengthAwarePaginator 实例 : 


protected function paginator($items, $total, $perPage, $currentP 
age, $options) 
{ 
return Container: :getInstance()->makeWwith(LengthAwarePaginat 
or::class, compact( 
'items', 'total', 'perPage', 'currentPage', 'options' 


)); 


LengthAwarePaginator 的 初始 化 : 


public function __construct($items, $total, $perPage, $currentPa 
ge = null, array $options = []) 
{ 
foreach ($options as $key => $value) { 
$this->{$key} = $value; 


$this->total = $total; 

$this->perPage = $perPage; 

$this->lastPage = max((int) ceil($total / $perPage), 1); 

$this->path = $this->path !== '/' ? rtrim($this->path, '/') 
: $this->path; 

$this->currentPage = $this->setCurrentPage($currentPage, $th 
is->pageName) ; 

$this->items = $items instanceof Collection ? $items : Colle 
ction: :make($items); 


} 


分 页 资源 render 


对 LengthAwarePaginator 调用 render 函数 会 得 到 分 页 所 需要 的 前 端 资源 : 


public function render($view = null, $data = []) 
{ 
return new HtmlString(static::viewFactory()->make($view ?: s 
tatic::$defaultView, array merge($data, [ 
'paginator' -» $this, 
'elements' => $this->elements(), 
]))->render()); 


当 我 们 使 用 默认 的 分 页 样式 的 时 候 ， 不 需要 向 render BRA view 参数 ， 
此 时 程序 会 自动 加 载 默 认 的 前 端 资源 : 


public static $defaultView = 'pagination::default'; 


该 资源 的 默认 地 址 是 


illuminate\Pagination\resources\views\default.blade.php : 


Qif ($paginator-»hasPages()) 
«ul class="pagination"> 
{{-- Previous Page Link --}} 
Qif ($paginator-»onFirstPage()) 
«li class="disabled"><span><<</span></1i> 
Qelse 
<li><a href="{{ $paginator-»previousPageUrl() }}" re 
1="prev"><<</a></1i> 
@endif 


{{-- Pagination Elements --}} 
@foreach ($elements as $element) 
{{-- "Three Dots" Separator --}} 
Qif (is string(S$element)) 
«li class="disabled"><span>{{ $element }}</span> 
</li> 
Qendif 


{{-- Array Of Links --}} 
@if (is_array($element)) 
@foreach ($element as $page => $url) 


Qif ($page == $paginator->currentPage() ) 
«li class="active"><span>{{ $page }}</sp 


an></1i> 
@else 
<li><a href="{{ $url }}">{{ $page }}</a> 
</li> 
@endif 
@endforeach 
@endif 
@endforeach 


{{-- Next Page Link --}} 
Qif ($paginator->hasMorePages( ) ) 
<li><a href="{{ $paginator->nextPageUr1l() }}" rel="n 
ext">>></a></1i> 
@else 
<li class="disabled"><span>>></span></1i> 
@endif 
</ul> 
@endif 


可 以 看 到 ， 分 页 效果 的 代码 分 为 三 部 分 : 前 一 页 、 后 一 页 、 分 页 元 素 。 


public function onFirstPage() 
{ 


return $this->currentPage() <= 1; 


否则 的 话 ， 就 要 为 ”前 一 页 按钮 赋予 链 接 : 


public function previousPageUrl() 


{ 
if ($this->currentPage() > 1) { 
return $this->url($this->currentPage() - 1); 
} 
} 
public function url($page) 
{ 
if ($page <= 0) { 
$page = 1; 
} 
$parameters = [$this->pageName => $page]; 
if (count($this->query) > 0) { 
$parameters = array_merge($this->query, $parameters); 
} 
return $this->path 
‘(Str::contains($this->path, 2^5) ? '&' = EI 
) 
.http build query($parameters, '', '&') 
.$this->buildFragment(); 
} 


eee |) 


如 果 列 表 页 中 存在 一 些 搜索 条 件 ， 这 些 搜索 条 件 会 被 加 载 到 $this->query 成 员 
变量 中 ， 生 成 url 的 时 候 ， 这 些 搜索 添加 会 被 加 到 request 的 参数 中 。 可 以 
使 用 append 方法 附加 查询 参数 到 分 页 链接 中 : 


public function appends($key, $value = null) 


{ 
if (is_array($key)) { 
return $this->appendArray($key); 


return $this->addQuery($key, $value); 


protected function appendArray(array $keys) 


1 
foreach ($keys as $key => $value) { 
$this->addQuery($key, $value); 


J 
return $this; 
} 
下 -一 页 


Jy 


public function hasMorePages() 


( 


return $this-»currentPage() < $this->lastPage(); 


下 一 页 的 链接 : 


public function nextPageUrl() 


{ 
if ($this->lastPage() > $this->currentPage()) { 
return $this->url($this->currentPage() + 1); 


前 一 页 类似 ， 如 果 已 经 在 最 后 一 页 ， 那 么 下 一 页 按钮 将 会 
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上 一 页 与 下 一 页 按钮 的 功能 比较 简单 ， 至 于 中 间 的 分 页 特效 比较 复杂 ， 我 们 由 
下 一 节 来 说 。 


分 页 elements 


我 们 先 说 一 下 不 同 的 分 页 样式 : 


e 当 我 们 设置 两 侧 页 数 为 3 时 ， 当 前 数据 总 页 数 小 于 8 页 时 分 页 效果 : 


。 总 页 数 大 于 6 页 ， 且 当前 页 在 前 8 页 (2* 3 + 2) 时 分 页 效果 : 


« 1 2 I5 1X | ia | .. [382 | 589 |] » 


e 当前 页 在 前 6 页 与 后 6 页 之 间 分 页 效果 : 


分 页 效果 样式 的 关键 来 源 于 Urlwindow ， 这 个 类 用 于 根据 总 页 数 与 当前 页 的 不 同 


one 
390 
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protected function elements() 


{ 
$window = UrlWindow: :make($this); 
return array_filter([ 
$window['first'], 
is array($window['slider']) ? '...' : null, 
$window['slider'], 
is array($window['last']) ? '...' : null, 
$window['last'], 
1); 
j 
public static function make(PaginatorContract $paginator, $onEac 
hside - 3) 
{ 
return (new static($paginator ) )->get($onEachSide) ; 
j 
public function get($onEachSide = 3) 
{ 
if ($this->paginator->lastPage() < (SonEachSide * 2) + 6) { 
return $this->getSmallSlider(); 
} 
return $this->getUrlSlider ($onEachSide) ; 
} 


小 型 分 页 getSmallSlider 


如 果 当 前 总 页 数 小 于 (SonEachSide * 2) + 6 的 话 ， 就 会 调用 小 型 分 页 效果 ， 
这 种 小 型 分 页 效果 直接 将 所 有 页 数 全 部 显示 : 


protected function getSmallSlider() 


{ 
return [ 
'first' => $this->paginator->getUrlRange(i, $this->last 
Page()), 
'slider' => null, 
'last' -» null, 
l; 
} 
public function getUrlRange($start, $end) 
{ 
return collect(range($start, $end) )->mapwithKeys(function ($ 
page) { 
return [$page => $this->url($page) ]; 
$)->all(); 
} 


CloseToBeginning 分 页 效果 


当前 页 数位 于 前 ($onEachside * 2) 页 时 : 


protected function getUrlSlider($onEachSide) 
{ 


$window = $onEachSide * 2; 


if (! $this->hasPages()) { 
return ['first' => null, 'slider' => null, 'last' => null 


1; 


if ($this->currentPage() <= $window) { 
return $this->getSliderTooCloseToBeginning($window) ; 


elseif ($this->currentPage() > ($this->lastPage() - $window) 
) í 


return $this->getSliderTooCloseToEnding($window); 


return $this->getFullSlider($onEachSide); 


protected function getSliderTooCloseToBeginning($window) 


( 


return [ 
'first' => $this->paginator->getUrlRange(i, $window + 2) 


'slider' => null, 
'last' => $this->getFinish(), 
]; 


} 
public function getFinish() 
{ 
return $this->paginator->getUrlRange( 
$this->lastPage() - 1, 
$this->lastPage() 
); 
} 
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假设 我 们 设置 当前 两 侧 页 数 为 3， 当前 页 为 5， 总 页 数 22， 部 数 
getSliderTooCloseToBeginning 返回 结果 为 : 


return [ 
'first' => [ 

1 => '/www.example.com/example?page=1', 
=> '/www.example.com/example?page-2' 
=> '/www.example.com/example?page-3' 

'/www.example.com/example?page=4 ' 
=> '/www.example.com/example?page-5' 
=> '/www.example.com/example?page=6' 
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=> '/www.example.com/example?page-7' 
8 => '/www.example.com/example?page-8'], 
'slider' => null, 
'last' => [ 
21 => '/www.example.com/example?page=21', 
22 => '/www.example.com/example?page=22'], 


1; 


这 个 时 候 element ARPA : 


400 


Laravel Database 分 页 原理 与 源码 分 析 





protected function elements() 


{ 
$window = UrlWindow: :make($this); 
return array_filter([ 
$window['first'], 
is array($window['slider']) ? '...' : null, 
$window['slider'], 
is array($window['last']) ? '...' : null, 
$window['last'], 
1); 
} 
/ /3& V] 25 7. 
[ 
[ 
1 => '/www.example.com/example?page-1', 
2 => '/www.example.com/example?page-2', 
3 => '/www.example.com/example?page=3', 
4 => '/www.example.com/example?page=4', 
5 => '/www.example.com/example?page=5', 
6 => '/www.example.com/example?page=6', 
7 => '/www.example.com/example?page=7', 
8 => '/www.example.com/example?page=8', 
], //$window['first'] 
scd //is array($window 
[Nasce EP ee, i! 
[ 
21 => '/www.example.com/example?page=21', 
22 => '/www.example.com/example?page=22', 
ie //$window['last' ] 
] 


TooCloseToEnding 分 页 效果 


当前 页 数位 于 后 ($onEachside * 2) 页 时 : 


401 


protected function getSliderTooCloseToEnding($window) 
1 
$last = $this-»paginator-»getUrlRange( 
$this->lastPage() - ($window + 2), 
$this->lastPage() 
); 


return [ 
'first' => $this->getStart(), 
'slider' => null, 
'last' => $last, 

l; 


} 
public function getStart() 
{ 
return $this->paginator->getUrlRange(i, 2); 
j 


假设 我 们 设置 当前 两 侧 页 数 为 3， 当 前 页 为 18， 总 页 数 22， 函 数 
getSliderTooCloseToEnding 返回 结果 为 : 
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return [ 
'first' => [ 
1 => '/www.example.com/example?page=1', 
2 => '/www.example.com/example?page-2' 
], 
‘slider? => null, 
'last' => [ 
15 => '/www.example.com/example?page=15', 
16 => '/www.example.com/example?page=16', 
17 => '/www.example.com/example?page=17', 
18 => '/www.example.com/example?page=18', 
19 => '/www.example.com/example?page=19', 
20 => '/www.example.com/example?page=20', 
21 => '/www.example.com/example?page=21', 
22 => '/www.example.com/example?page=22', 
], 
l; 


这 个 时 候 element MARAE: 


[ 
[ 
1 => '/www.example.com/example?page=1', 
2 => '/www.example.com/example?page-2' 
], 
[ 
15 => '/www.example.com/example?page=15', 
16 => '/www.example.com/example?page=16', 
17 => '/www.example.com/example?page=17', 
18 => '/www.example.com/example?page=18', 
19 => '/www.example.com/example?page=19', 
20 => '/www.example.com/example?page-20', 
21 => '/www.example.com/example?page-21', 
22 => '/www.example.com/example?page=22', 
] 
] 
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FullSlider 分 页 效果 
当前 页 数位 于 中 间 时 : 


protected function getFullSlider($onEachSide) 


{ 
return [ 
'first' => $this->getStart(), 
'slider' => $this->getAdjacentUrlRange($onEachSide), 
ast. => $this->getFinish(), 
l; 
} 


public function getAdjacentUrlRange($onEachSide) 
1 


return $this-»paginator-»getUrlRange( 
$this->currentPage() - $onEachSide, 
$this->currentPage() + $onEachSide 


); 


假设 我 们 设置 当前 两 侧 页 数 为 3， 当 前 页 为 10» i33 322 BR 
getFullslider 返回 结果 为 : 


Laravel Database 一 一 分 页 原理 与 源码 分 析 


return [ 


Best == [i 


1 => '/www.example. 


2 => '/www.example. 


], 


'slider' => [ 


7 
8 
9 
10 
dE 
12 
T3 

], 

‘last ' 
Za 
22 

], 

l; 


=> 

=> 

=> 
=> 
=> 
=> 


=> 


'/www. example. 
'/www. example. 
'/www. example. 


'/www. example. 
'/www. example. 
'/www. example. 
'/www. example. 


'/www. example. 
'/www. example. 


com/example?page=1', 
com/example?page=2' 


com/example?page=7', 
com/example?page=8', 
com/example?page=9', 
com/example?page=10', 
com/example?page=11', 
com/example?page=12', 
com/example?page=13', 


com/example?page=21', 
com/example?page=22', 


这 个 时 候 element MARAE: 
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Laravel Database 一 一 分 页 原理 与 源码 分 析 


[ 
[ 
1 => '/www.example.com/example?page=1', 
2 => '/www.example.com/example?page-2' 
], 
[ 
7 => '/www.example.com/example?page=7', 
8 => '/www.example.com/example?page=8', 
9 => '/www.example.com/example?page=9', 
10 => '/www.example.com/example?page=10', 
11 => '/www.example.com/example?page=11', 
12 => '/www.example.com/example?page=12', 
13 => '/www.example.com/example?page=13', 
], 
[ 
21 => '/www.example.com/example?page-21', 
22 => '/www.example.com/example?page=22', 
] 
] 


simplePaginate 简单 分 页 


简单 分 页 相 比 以 上 的 功能 来 说 ， 精简 了 elements 的 特效 : 
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public function simplePaginate($perPage = 15, $columns = ['*'], 
$pageName = 'page', $page = null) 
{ 


$page = $page ?: Paginator::resolveCurrentPage($pageName) ; 
$this->skip(($page - 1) * $perPage)->take($perPage + 1); 


return $this->simplePaginator($this->get($columns), $perPage 
, Spage, [ 
'path' => Paginator::resolveCurrentPath(), 
'pageName' => $pageName, 


]); 


protected function simplePaginator($items, $perPage, $currentPag 
e, $options) 
{ 
return Container: :getInstance()->makeWith(Paginator::class, 
compact ( 
'items', 'perPage', 'currentPage', 'options' 


2): 


分 页 服务 的 类 不 再 使 用 LengthAwarePaginator 类 ， 而 开始 使 用 
Paginator ， 这 两 个 类 最 大 的 不 同 在 于 render BX: 


public static $defaultSimpleView = 'pagination::simple-default'; 


public function render($view = null, $data = []) 
{ 
return new HtmlString( 
static::viewFactory()-»make($view ?: static::$defaultSim 
pleView, array merge($data, [ 
'paginator' => $this, 
]))-»render() 
); 


render H žE A 85 qp 3r HR SR OBE 


illuminateNPaginationNresourcesNviewsNsimple-default.blade.php : 


Qif ($paginator ->hasPages()) 
<ul class="pagination"> 
{{-- Previous Page Link --}} 
Qif ($paginator-»onFirstPage()) 
«li class="disabled"><span>@lang('pagination.previou 
s')</span></1i> 
@else 
<li><a href="{{ $paginator-»previousPageUrl() }}" re 
1l="prev">@lang('pagination.previous' )</a></1li> 
@endif 


{{-- Next Page Link --}} 
Qif (S$paginator->hasMorePages()) 
<li><a href="{{ $paginator->nextPageUr1() }}" rel="n 
ext">@lang('pagination.next' )</a></1li> 
@else 
<li class="disabled"><span>@lang('pagination.next')< 
/span></1i> 
@endif 
</ul> 
@endif 


可 以 看 到 ， 简 单 分 页 只 有 上 一 (ONT dE e 


| 

= 
| 

= 


获取 模型 
get 函数 


public function get($columns = ['*']) 


t 
$builder = $this->applyScopes(); 
if (count($models = $builder->getModels($columns)) > 9) ( 
$models = $builder->eagerLoadRelations($models) ; 
J 
return $builder-»getModel()-»newCollection($models); 
} 


public function getModels($columns = ['*']) 


{ 
return $this->model->hydrate( 
$this-»query-»get($columns)-»all() 
)->all(); 
} 


get HAAI QueryBuilder 所 获取 的 数据 进一步 包装 

hydrate ° hydrate 函数 会 将 数据 库 取 回来 的 数据 打包 成 数据 库 模 型 对 象 
Eloquent Model ， 如 果 可 以 获取 到 数据 ， 还 会 利用 吕 数 
eagerLoadRelations 来 预 加 载 关 系 模型 。 


public function hydrate(array $items) 


{ 


$instance = $this-»newModelInstance(); 


return $instance->newCollection(array_map(function ($item) u 
se ($instance) { 
return $instance->newFromBuilder ($item) ; 
}, $items)); 


newModelInstance 函数 创建 了 一 个 新 的 数据 库 模 型 对 象 ， 重 要 的 是 这 个 函数 为 
新 的 数据 库 模 型 对 象 典 了 予 了 connection 


public function newModelInstance($attributes = []) 


i 


return $this->model->newInstance($attributes) ->setConnection 


$this->query ->getConnection( )->getName( ) 


); 


newFromBuilder BAA A BERBERA AN Eloquent Model 


的 attributes 中 : 


public function newFromBuilder($attributes = [], $connection = n 
ull) 


{ 
$model = $this->newInstance([], true); 
$model->setRawAttributes((array) $attributes, true); 
$model->setConnection($connection ?: $this->getConnectionNam 
e()); 
$model->fireModelEvent('retrieved', false); 
return $model; 
} 


newlnstance 有 函数 专用 于 创建 新 的 数据 库 对 象 模型 : 


public function newInstance($attributes = [], $exists = false) 
{ 


$model = new static((array) $attributes); 
$model->exists = $exists; 


$model->setConnection( 
$this->getConnectionName( ) 


): 


return $model; 


值得 注意 的 是 newInstance 将 exist HAA true ， 意 味 着 当前 这 个 数据 库 
模型 对 象 是 从 数据 库 中 获取 而 来 ， 并 非 是 手动 新 建 的 ， 这 个 exist AL? AT 
能 对 这 个 数据 库 对 象 进行 update 。 


setRawAttributes 函数 为 新 的 数据 库 对 象 赋予 属性 值 ， 并 且 进 行 sync ， 标 志 
着 对 象 的 原始 状态 : 


public function setRawAttributes(array $attributes, $sync = fals 
e) 


1 
$this->attributes = $attributes; 
if ($sync) { 
$this->syncOriginal(); 
} 
return $this; 
} 


public function syncOriginal() 


( 


$this->original = $this->attributes; 


return $this; 


这 个 原始 状态 的 记录 十 分 重要 ， 原 因 是 save 函数 就 是 利用 原始 值 original 
与 属性 值 attributes 的 差异 来 决定 更 新 的 字段 。 
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find 遂 数 用 于 利用 主键 id 来 查询 数据 ， find 函数 也 可 以 传 入 数组 ， 查 询 
多 个 数据 


public function find($id, $columns = ['*']) 


{ 
if (is_array($id) || $id instanceof Arrayable) { 
return $this->findMany($id, $columns); 
} 
return $this->whereKey($id)->first($columns) ; 
} 
public function findMany($ids, $columns = ['*']) 
1 
if (empty($ids)) { 
return $this->model->newCollection(); 
} 
return $this->whereKey($ids)->get($columns); 
} 


findOrFail 


laravel 还 提供 findOrFail 函数， 一 般 用 于 controller ， 在 未 找到 记录 
的 时 候 会 抛 出 异常 。 


public function findOrFail($id, $columns = ['*']) 


{ 
$result = $this->find($id, $columns); 
if (is_array($id)) { 
if (count($result) == count(array unique($id))) { 
return $result; 
} 
} elseif (! is_null($result)) { 
return $result; 
} 
throw (new ModelNotFoundException) ->setModel( 
get_class($this->model), $id 
); 
} 


其 他 查询 与 数据 获取 方法 


所 用 Query Builder 支持 的 查询 方法 ， 例 如 

select ^ selectSub ^ whereDate ^ whereBetween 等 等 ,都 可 以 直接 对 
Eloquent Model 直接 使 用 ， 程 序 会 通过 魔术 方法 调用 Query Builder 的 相关 
方法 : 


protected $passthru = [ 

'insert', 'insertGetId', 'getBindings', 'toSql', 

'exists', 'count', 'min', 'max', 'avg', 'sum', 'getConnectio 
mas 


. 
, 


public function _ call($method, $parameters) 


{ 
if (in_array($method, $this->passthru)) { 
return $this->toBase()->{$method}(...$parameters) ; 
} 
$this->query->{$method}(...$parameters); 
return $this; 
} 


passthru 中 的 各 个 函数 在 调用 前 需要 加 载 查询 作用 域 ， 原 因 是 这 些 操作 基本 上 
是 aggregate 的 ， 需 要 添加 搜索 条 件 才 能 更 加 符合 预期 : 


public function toBase() 


{ 
return $this->applyScopes()->getQuery(); 


添加 和 更 新 模型 


save 有 函数 


在 Eloquent Model 中 ， 添 加 与 更 新 模型 可 以 统一 用 save 函数 。 在 添加 模型 
的 时 候 需 要 事先 为 model 属性 赋值 可 以 单个 手动 赋值 ;也 可 以 批量 赋值 。 在 更 
新 模型 的 时 候 ， 需 要 事先 从 数据 库 中 取出 模型 ， 然 后 修改 模型 属性 ， 最 后 执行 
save 更 新 操作 。 官 方 文档 : 添加 和 更 新 模型 


public function save(array $options = []) 


{ 
$query = $this->newQuerywithoutScopes(); 


if ($this->fireModelEvent('saving') === false) { 
return false; 


if ($this->exists) { 
$saved = $this->isDirty() ? 
$this->performUpdate($query) : true; 


else { 
$saved = $this->performInsert ($query) ; 


if (! $this->getConnectionName() && 
$connection = $query->getConnection()) { 
$this->setConnection($connection->getName()); 


if ($saved) { 
$this->finishSave($options); 


return $saved; 


save 函数 不 会 加 载 全 局 作用 域 ， 原 因 是 凡是 利用 save 函数 进行 的 插入 或 者 更 
新 的 操作 都 不 会 存在 where 条件， 仅仅 利用 自身 的 主键 属性 来 进行 更 新 。 如 果 需 
要 where 条 件 可 以 使 用 query\builder 的 update 有 函数 ， 我 们 在 下 面 会 详 
细 介 绍 : 


public function newQueryWithoutScopes() 


( 


$builder = $this->newEloquentBuilder ($this->newBaseQueryBuil 
der()); 


return $builder->setModel($this) 
-»with($this-»with) 
-»withCount($this-»withCount); 


protected function newBaseQueryBuilder() 


( 


$connection = $this->getConnection(); 


return new QueryBuilder( 
$connection, $connection->getQueryGrammar(), $connection 
-»getPostProcessor() 


); 


newQueryWithoutScopes 元 数 创建 新 的 没有 任何 其 他 条 件 的 
Eloquent\builder 类 ， 而 Eloquent\builder 类 需要 Query\builder AX 
作为 底层 查询 构造 器 。 


performUpdate 有 函数 


如 果 当 前 的 数据 库 模 型 对 象 是 从 数据 库 中 取出 的 ， 也 就 是 直接 或 间接 的 调用 
get() 函数 从 数据 库 中 获取 到 的 数据 库 对 象 ， 那 么 其 exists 必然 是 true 


public function isDirty($attributes = null) 
{ 
return $this->hasChanges( 
$this->getDirty(), is_array($attributes) ? $attributes : 
func. get args() 
); 


} 
public function getDirty() 
{ 
$dirty = []; 
foreach ($this->getAttributes() as $key => $value) { 
if (! $this->originalIsEquivalent($key, $value)) { 
$dirty[$key] = $value; 
} 
} 
return $dirty; 
} 


getDirty 函数 可 以 获取 所 有 和 与 原始 值 不 同 的 属性 值 ， 也 就 是 需要 更 新 的 数据 库 
字段 。 关 键 函 数 在 于 originalIsEquivalent 


protected function originallsEquivalent($key, $current) 
1 
if (! array key exists($key, $this->original)) { 
return false; 


$original = $this->getOriginal($key); 


if ($current === $original) { 
return Erue; 
} elseif (is_null($current)) { 
return false; 
} elseif ($this->isDateAttribute($key)) { 
return $this->fromDateTime($current) === 
$this->fromDateTime($original); 
} elseif ($this->hasCast($key)) { 
return $this->castAttribute($key, $current) === 
$this->castAttribute($key, $original); 


return is_numeric($current) && is_numeric($original) 
&& strcmp((string) $current, (string) $original) === 
0; 
} 
| —— ÁÁssáÀwi : i] 
可 以 看 到 ， 对 于 数据 库 可 以 转化 的 属性 都 要 先进 行 转化 ， 然 后 再 开始 对 比 。 比 较 出 
的 结果 ， 就 是 我 们 需要 update 的 字段 。 


执行 更 新 的 时 候 ， 除 了 getbirty 函数 获得 的 待 更 新 字段 ， 还 会 有 


UPDATED AT 这 个 字段 : 


protected function performUpdate(Builder $query) 


if ($this->fireModelEvent('updating') === false) { 
return false; 


if ($this->usesTimestamps()) { 


$this->updateTimestamps(); 


$dirty = $this->getDirty(); 


if (count($dirty) > 0) { 
$this->setKeysForSaveQuery ($query ) ->update($dirty); 


$this->fireModelEvent('updated', false); 


$this->syncChanges(); 


return true; 


protected function updateTimestamps( ) 


{ 


$time = $this->freshTimestamp(); 


if (! is_null(static::UPDATED_AT) && ! $this->isDirty(static 
: :UPDATED AT)) { 
$this->setUpdatedAt ($time); 


} 
if (! $this->exists && ! $this->isDirty(static::CREATED_AT)) 
{ 
$this->setCreatedAt($time) ; 
} 
} 


执行 更 新 的 时 候 ， where 条 件 只 有 一 个 ， 那 就 是 主键 id 


protected function setKeysForSaveQuery(Builder $query) 


{ 
$query->where($this->getKeyName(), '-', $this->getKeyForSave 


Query()); 


return $query; 


} 
protected function getKeyForSaveQuery( ) 
{ 

return $this->original[$this->getKeyName( ) ] 

?? $this->getKey(); 

} 
public function getKey() 
{ 

return $this->getAttribute($this->getKeyName() ); 
} 


最 后 会 调用 EloquentBuilder update 函数 : 


public function update(array $values) 
{ 

return $this->toBase()->update($this->addUpdatedAtColumn($va 
lues)); 


j 


protected function addUpdatedAtColumn(array $values) 
{ 
if (! $this->model->usesTimestamps()) { 
return $values; 


return Arr: :add( 
$values, $this->model->getUpdatedAtColumn(), 
$this->model->freshTimestampString( ) 


): 


j 
public function freshTimestampString() 
{ 
return $this->fromDateTime($this->freshTimestamp()); 
j 


public function fromDateTime( $value) 


t 
return is null($value) ? $value : $this->asDateTime( $value) - 
>format ( 
$this->getDateFormat() 


); 


performinsert 


关于 数据 库 对 象 的 插入 ， 如 果 数 据 库 的 主键 被 设置 为 increment ， 也 就 是 自 增 的 
话 ， 程 序 会 调用 insertAndSetId ， 这 个 时 候 不 需要 给 数据 库 模 型 对 象 手 动 赋值 
主键 id 。 若 果 数 据 库 的 主键 并 不 支持 自 增 ， 那 么 就 需要 在 插入 前 ， 为 数据 库 对 
象 的 主键 id 赋值 ， 否则 数据 库 会 报错 。 


protected function performInsert(Builder $query) 


{ 
if ($this->fireModelEvent('creating') === false) { 
return false; 


if ($this->usesTimestamps()) { 


$this->updateTimestamps(); 


$attributes = $this->attributes; 


if ($this->getIncrementing()) { 
$this->insertAndSetIid($query, $attributes); 


J 
else ( 
if (empty($attributes)) { 
returni enue; 
} 
$query->insert($attributes); 
} 


$this->exists = true; 
$this->wasRecentlyCreated = true; 
$this->fireModelEvent('created', false); 


return Enue; 


laravel 默认 数据 库 的 主键 支持 自 增 属 性 ， 程 序 调用 的 也 是 函数 
insertAndSetId 44x: 


protected function insertAndSetId(Builder $query, $attributes) 


{ 
$id = $query->insertGetId($attributes, $keyName = $this->get 
KeyName()); 


$this->setAttribute($keyName, $id); 


插入 后 ， 会 将 插入 后 得 到 的 主键 id 返回 ， 并 赋值 到 模型 的 属性 当中 。 


如 果 数 据 库 主键 不 支持 自 增 ， 那 么 我 们 在 数据 库 类 中 要 设置 : 


public $incrementing = false; 
每 次 进行 插入 数据 的 时 候 ， 需 要 手动 给 主键 赋值 。 


update 42 


save 函数 仅仅 支持 手动 的 属性 典 值 ， 无 法 批量 赋值 。 laravel 的 Eloquent 
Model 还 有 一 个 函数 : update 支持 批量 属性 赋值 。 有 意思 的 是 ， Eloquent 
Builder 也 有 函数 update ， 那 个 是 上 一 小 节 提 到 的 performUpdate 所 调用 
的 函数 


A update 功能 一 致 ， 只 是 Model 的 update 有 子 数 比较 适用 于 更 新 从 数据 
库 取 回 的 数据 库 对 象 : 


$flight = App\Flight::find(1); 

$flight->update(['name' => 'New Flight Name','desc' => 'test']); 
而 Builder 的 update 适用 于 多 查询 条 件 下 的 更 新 : 

AppNFlight::where('active', 1) 


->where('destination', 'San Diego') 
->update(['delayed' => 1]); 


无 论 哪 一 种 ， 都 会 自动 更 新 updated at 字段 。 


Model 的 update 有 函数 借助 fill BRA save HK: 


public function update(array $attributes = [], array $options = 


15) 


1 
if (! $this->exists) { 
return false; 
} 
return $this->fill($attributes)->save($options); 
} 


make X 


同样 的 ， save 的 插入 也 仅仅 支持 手动 属性 赋值 ， 如 果 想 实现 批量 属性 赋值 的 播 
入 可 以 使 用 make 有 函数 : 


$model = App\Flight::make(['name' => 'New Flight Name','desc' => 
SES ea) 


$model->save(); 
El mm zs 


make 元 数 实际 上 仅仅 是 新 建 了 一 个 Eloquent Model ， 并 批量 赋予 属性 值 : 


public function make(array $attributes = []) 


{ 


return $this->newModelInstance($attributes) ; 


public function newModelInstance($attributes = []) 


( 


return $this->model->newInstance($attributes) ->setConnection 


$this-»query-»getConnection()-»getName( ) 


); 


create 有 函数 
如 果 想 要 一 步 到 位 ， 批 量 赋值 属性 与 插入 一 起 操作 ， 可 以 使 用 create £X: 


App\Flight::create(['name' => 'New Flight Name','desc' => 'test' 
1); 


相 比 较 make A% > create 有 函数 更 进一步 调用 了 save BH: 


public function create(array $attributes = []) 


{ 
return tap($this->newModelInstance($attributes), function ($ 
instance) { 
$instance->save(); 


3): 


实际 上 ， 属 性 值 是 否 可 以 批量 赋值 需要 受 fillable 或 guarded 来 控制 ， 如 果 
我 们 想 要 强制 批量 赋值 可 以 使 用 forceCreate 


public function forceCreate(array $attributes) 


{ 
return $this->model->unguarded(function () use ($attributes) 
{ 
return $this->newModelInstance()->create($attributes); 
3); 
} 
‘| = zl 








findOrNew 43x 


laravel 提供 一 种 主键 查询 或 者 新 建 数据 库 对 象 的 函数 : findOrNew 


public function findOrNew($id, $columns = ['*']) 


{ 
if (! is_null($model = $this->find($id, $columns))) { 
return $model; 
J 
return $this-»newModelInstance(); 
} 


值得 注意 的 是 ， 当 查询 失败 的 时 候 ， 会 返回 一 个 全 新 的 数据 库 对 象 ， 不 含有 任何 


attributes ° 


firstOrNew 2 


laravel 提供 一 种 自 定义 查询 或 者 新 建 数 据 库 对 象 的 函数 : firstorNew 


public function firstOrNew(array $attributes, array $values = []) 


if (! is null($instance = $this->where($attributes) ->first() 


DE: 


return $instance; 


return $this->newModelInstance($attributes + $values); 


} 
E n 


值得 注意 的 是 ， 如 果 查 询 失 败 ， 会 返回 一 个 含有 attributes 和 values 两 者 
含 并 的 属性 的 数据 库 对 象 。 


firstOrCreate % žr 


EMT firstorNew 2° firstOorCreate 有 函数 也 用 于 自 定 义 查 询 或 者 新 建 数 
据 库 对 象 ， 不 同 的 是 ， firstorCreate 函数 还 进一步 对 数据 进行 了 插入 操作 : 


public function firstOrCreate(array $attributes, array $values = 


[1) 
{ 


if (! is_null($instance = $this->where($attributes) ->first() 


DX 


return $instance; 


return tap($this->newModeliInstance($attributes + $values), f 
unction ($instance) { 
$instance->save(); 


3): 


updateOrCreate 函数 


在 firstOrCreate 函数 基础 上 ， 除 了 对 数据 进行 查询 ， 还 会 对 查询 成 功 的 数据 
利用 value 进行 更 新 : 


public function updateOrCreate(array $attributes, array $values 
zuo 
{ 
return tap($this->firstOrNew($attributes), function ($instan 
ce) use (values) 4 
$instance->fill($values) ->save(); 


3); 


firstOr X 


如 果 想 要 自 定 义 查找 失败 后 的 操作 ， 可 以 使 用 firstor 遂 数 ， 该 函数 可 以 传 入 闭 
包 函 数 ， 处 理 找 不 到 数据 的 情况 : 


public function firstOr($columns = ['*'], Closure $callback = nu 
iT) 


{ 
if ($columns instanceof Closure) { 
$callback = $columns; 


$columns = ['*']; 


if (! is_null($model = $this->first($columns))) { 
return $model; 


return call_user_func($callback); 


M T Ae 7 


删除 模型 也 会 分 为 两 种 ， 一 种 是 针对 Eloquent Model 的 删除 ， 这 种 删除 必须 是 
从 数据 库 中 取出 的 对 象 。 还 有 一 种 是 Eloquent Builder 的 删除 ， 这 种 删除 一 般 
会 带 有 多 个 查询 条 件 。 我 们 这 一 小 节 主 要 讲 model 的 删除 : 


public function delete() 


{ 
if (is null($this-»getKeyName())) { 
throw new Exception('No primary key defined on model.'); 
} 
if (! $this->exists) { 
Ret UM: 
} 
if ($this->fireModelEvent('deleting') === false) { 
return false; 
} 
$this->touchOwners(); 
$this->performDeleteOnModel(); 
$this->fireModelEvent('deleted', false); 
return true; 
} 


删除 模型 时 ， 模 型 对 象 必 然 要 有 主键 。 performDeleteonModel 函数 执行 具体 的 
删除 操作 : 


protected function performDeleteOnModel() 


1 
$this-»5setKeysForSaveQuery($this-»newQueryWithoutScopes())-» 
delete(); 


$this->exists = false; 


protected function setKeysForSaveQuery(Builder $query) 


{ 
$query->where($this->getKeyName(), '-', $this->getKeyForSave 


Query()); 


return $query; 


所 以 实际 上 ， Model 调用 的 也 是 builder 的 delete Až ° 


AXI ER 


如 果 想 要 使 用 软 删 除 ， 需 要 使 用 

Illuminate\Database\Eloquent\SoftDeletes 这 个 trait。 并 且 需 要 定义 软 删 
RFR’ RUA deleted at ， 将 软 删除 字段 放 入 dates 中 ， 上 有 具体 用 法 可 参考 
官方 文档 : 软 删 除 


class Flight extends Model 
{ 


use SoftDeletes; 


A** 
* 需要 被 转换 成 日 期 的 属性 。 
* @var array 
T" 
protected $dates - ['deleted at']; 


RIAA AIK trait 


trait SoftDeletes 


{ 
public static function bootSoftDeletes() 
{ 
static: :addGlobalScope(new SoftDeletingScope) ; 
} 
} 


如 果 使 用 了 软 删 除 ， 在 model 的 启动 过 程 中 ， 就 会 启动 软 删除 的 这 个 函数 。 可 以 
看 出 来 ， 软 删除 是 需要 查询 作用 域 来 合作 发 挥 作用 的 。 我 们 看 看 这 个 
SoftDeletingScope 


class SoftDeletingScope implements Scope 


{ 
protected $extensions = ['Restore', 'WithTrashed', 'WithoutT 
rashed', 'OnlyTrashed']; 


public function apply(Builder $builder, Model $model) 


{ 
$builder ->whereNull($model->getQualifiedDeletedAtColumn( 
)); 
J 
public function extend(Builder $builder) 
it 
foreach ($this->extensions as $extension) { 
$this->{"add{$extension}"}($builder ); 
} 
$builder->onDelete(function (Builder $builder) { 
$column = $this->getDeletedAtColumn($builder) ; 
return $builder-»update([ 
$column => $builder->getModel()->freshTimestampS 
tring(), 
1); 
3); 
J 


apply 函数 是 加 载 全 局 域 调 用 的 函数 ， 每 次 进行 查询 的 时 候 ， 调 用 get 函数 就 
会 自动 加 载 这 个 函数 ， whereNull 这 个 查询 条 件 会 被 加 载 到 具体 的 where 条 
件 中 。 deleted at 字段 一 般 被 设置 为 null ， 在 执行 软 删 除 的 时 候 ， 该 字段 会 
被 赋予 时 间 格 式 的 值 ， 标 志 着 被 删除 的 时 间 。 


在 加 载 全 局 作用 域 的 时 候 ， 还 会 调用 extend ak? extend 2A model 
Whe T OP HA: 


e WithTrashed 


protected function addwithTrashed(Builder $builder ) 
{ 


$builder->macro('withTrashed', function (Builder $builder) { 
return $builder->withoutGlobalScope($this); 


3); 


withTrashed 函数 取消 了 软 删 除 的 全 局 作用 域 ， 这 样 我 们 查询 数据 的 时 候 就 会 查 
询 到 正常 数据 和 被 软 删 除 的 数据 。 


e WithoutTrashed 


protected function addWithoutTrashed(Builder $builder) 
{ 


$builder ->macro('withoutTrashed', function (Builder $builder ) 
$model = $builder-»getModel(); 


$builder ->withoutGlobalScope($this ) ->whereNull( 
$model->getQualifiedDeletedAtColumn( ) 


): 


return $builder; 


3): 


加 | 
withTrashed 遂 数 着 重 强 调 了 不 要 获取 和 软 删 除 的 数据 。 


e onlyTrashed 


protected function addOnlyTrashed(Builder $builder ) 
{ 
$builder->macro('onlyTrashed', function (Builder $builder) { 
$model = $builder-»getModel(); 


$builder ->withoutGlobalScope($this ) ->whereNotNull( 
$model->getQualifiedDeletedAtColumn( ) 
); 


return $builder; 


3): 


如 果 只 想 获取 被 软 删 除 的 数据 ， 可 以 使 用 这 个 函数 onlyTrashed ， 可 以 看 到 ， 它 
使 用 了 whereNotNull 。 


e restore 


protected function addRestore(Builder $builder ) 
{ 
$builder->macro('restore', function (Builder $builder) { 
$builder ->withTrashed(); 


return $builder->update([$builder ->getModel()->getDelete 


dAtColumn() => null]); 
p); 


如 果 想 要 恢复 被 删除 的 数据 ， 还 可 以 使 用 restore ， 重 新 将 deleted at 数据 
恢复 为 null 。 


performDeleteOnModel 


SoftDeletes 这 个 trait & €3X performDeleteOnModel 函数 ， 它 将 不 会 调用 
Eloquent Builder 的 delete 方法 ， 而 是 采用 更 新 操作 : 


protected function performDeleteOnModel( ) 
{ 
if ($this->forceDeleting) { 
return $this->newQuerywithoutScopes()->where($this->getk 
eyName(), $this-»getKey())-»forceDelete(); 


j 

return $this-»runSoftDelete(); 
j 
protected function runSoftDelete() 
{ 


$query = $this->newQueryWithoutScopes( )->where($this->getKey 
Name(), $this->getKey()); 


$time = $this->freshTimestamp(); 


$columns = [$this->getDeletedAtColumn() => $this->fromDateTi 
me($time) ]; 


$this->{$this->getDeletedAtColumn()} = $time; 


if ($this->timestamps) { 
$this->{$this->getUpdatedAtColumn()} = $time; 


$columns[$this->getUpdatedAtColumn()] = $this->fromDateT 


ime($time); 


} 


$query->update($columns) ; 


删除 操作 不 仅 更 新 了 deleted at ， 还 更 新 了 updated at 字段 。 


Laravel Database——Eloquent Model 关联 
源码 分 析 


数据 库 表 通常 相互 关联 。 laravel 中 的 模型 关联 功能 使 得 关于 数据 库 的 关联 代码 
变 得 更 加 简单 ， 更 加 优雅 。 本 文 会 详细 说 说 关于 模型 关联 的 源码 ， 以 便 更 好 的 理解 
和 使 用 关联 模型 。 官 方 文档 : Eloquent: 关联 


定义 关联 


所 谓 的 定义 关联 ， 就 是 在 一 个 Model 中 定义 一 个 关联 函数 ， 我 们 利用 这 个 关联 郊 
数 去 操作 另外 一 个 Model ， 例 如 ， user 表 是 用 户 表 ， posts 是 用 户 发 的 文 
章 ， 一 个 用 户 可 以 发 表 多 篇 文章 ， 我 们 就 可 以 这 样 写 : 


$user->posts()->where('active', 1)->get(); 


这 表明 了 我 们 想 通 过 $user 这 个 用 户 查 询 到 状态 active 为 1 的 所 有 文 


章 ， posts 就 是 关联 函数 ， 我 们 可 以 通过 这 个 关联 函数 去 操作 男 一 个 与 user 
关联 的 表 。 

在 说 模型 关联 的 定义 之 前 ， 我 们 要 先 说 说 父 模型 与 子 模型 的 概念 。 所 谓 的 父 模型 是 
指 在 模型 关系 中 主动 的 一 方 ， 例 如 用 户 模型 和 文章 模型 中 的 用 户 ， 相 应 的 子 模型 就 
是 模型 关系 中 的 被 动 一 方 ， 例 如 文章 模型 。 在 正 向 定义 中 ， 被 关联 的 是 子 模型 ， 而 
在 反 向 关联 中 ， 被 关联 的 是 父 模型 。 


我 们 知道 ， 关 联 有 多 种 形式 ， 各 种 关系 如 下 : 
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hasOne 一 对 一 
我 们 以 官方 文档 的 例子 来 说 明 ， 一 个 User 模型 可 能 关联 一 个 Phone 模型 : 


class User extends Model 


{ 
/** 
* 获得 与 用 户 关联 的 电话 记录 。 
yu 
public function phone() 
{ 
$this->hasOne('App\Phone', 'user id', 'id'); 
} 
} 


我 们 来 看 看 hasOne 的 源码 : 


437 


public function hasOne($related, $foreignKey = null, $localKey = 
null) 


i $instance = $this->newRelatedInstance($related); 
$foreignKey = $foreignKey ?: $this->getForeignKey(); 
$localKey = $localKey ?: $this->getKeyName(); 
return new HasOne($instance->newQuery(), $this, $instance->g 
etTable().'.'.$foreignKey, $localKey); 
} 


newRelatedInstance 有 函数 负责 建立 一 个 新 的 被 关联 的 模型 实例 ， 主 要 目的 是 设 
置 数据 库 连 接 : 


protected function newRelatedInstance($class) 


t 
return tap(new $class, function ($instance) { 
if (! $instance->getConnectionName()) { 
$instance->setConnection($this->connection) ; 
} 
}); 
} 


在 一 对 一 的 关系 中 ， foreignKey 外 键 名 默认 是 父 模型 的 类 名 和 主键 名 的 蛇 形 变 
€*^ localkey 是 父 模 型 的 主键 名 : 


public function getForeignkey() 
{ 


return Str::snake(class_basename($this)).'_'.$this->primaryKk 
ey; 
} 


hasOne 元 数 的 构造 函数 继承 HasOneOrMany 类 ， 也 就 是 说 ， 一 对 一 与 一 对 多 
构造 函数 相同 ， 这 部 分 主要 设置 外 键 名 : 


le 
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public function __construct(Builder $query, Model $parent, $fore 
ignKey, $localKey) 


1 
$this->localKey = $localKey; 
$this--foreignKey = $foreignKey; 
parent::  construct($query, $parent); 
} 


HasOneOrMany 类 继承 Relation 类 ， 这 部 分 主要 设置 parent ( 父 模型 )、 被 
关联 模型 (FRA) 与 被 关联 模型 (FRA) 的 查询 构造 器 : 


public function __construct(Builder $query, Model $parent ) 


{ 
$this->query = $query; 
$this->parent = $parent; 
$this->related = $query->getModel(); 


$this->addConstraints(); 


hasOne 的 模型 关系 如 下 : 


[ER 
user name 





除了 保存 被 关联 模型 的 查询 构造 器 、 被 关联 模型 与 parent 模型 之 外 ， 还 会 提供 
额外 的 限制 条 件 : 


public function addConstraints() 


{ 
if (static::$constraints) { 
$this->query->where($this->foreignKkey, '-', $this->getPa 
rentKey()); 


$this ->query->whereNotNull($this->foreignKkey) ; 


} 
} 
public function getParentKey() 
{ 
return $this->parent->getAttribute($this->localkey) ; 
} 


限制 条 件 为 被 关联 模型 和 关联 模型 建立 外 键 约束 关系 : 


select phone where phone.user_id = 1 (user.id) 


hasMany 一 对 多 


在 模型 关联 的 定义 中 ， 一 对 一 与 一 对 多 源码 是 一 样 的 : 


public function hasMany($related, $foreignKey = null, $localkey 
- null) 


i 


$instance = $this->newRelatedInstance($related) ; 
$foreignKey = $foreignKey ?: $this->getForeignKkey(); 
$1ocalKey = $localKey ?: $this->getKeyName(); 

return new HasMany( 


$instance->newQuery(), $this, $instance->getTable().'.'. 
$foreignKey, $localKey 


); 


hasMany 的 模型 关系 如 下 : 





限制 条 件 与 一 对 一 相同 ， 为 被 关联 模型 和 关联 模型 建立 外 键 约束 关系 : 


select phone where phone.user_id = 1 (user.id) 


belongsTo 一 对 一 、 一 对 多 反 向 关联 


如 果 想 要 从 文章 反 向 查找 作者 用 户 ， 那 么 可 以 定义 反 向 关联 : 


public function user() 


{ 
return $this->belongsTo('App\User', 'foreign key', 'other ke 


y'); 
} 


belongsTo 源码 : 


public function belongsTo($related, $foreignKey = null, $ownerKe 
y = null, $relation = null) 


{ 
if (is_null($relation)) { 
$relation = $this-»guessBelongsToRelation(); 
} 
$instance = $this-»newRelatedInstance($related); 
if (is null($foreignKey)) { 
$foreignKey = Str::snake($relation).' '.$instance-»getKe 
yName( ); 
} 
$ownerKey = $ownerKey ?: $instance->getKeyName(); 
return new BelongsTo( 
$instance->newQuery(), $this, $foreignKey, $ownerKey, $r 
elation 
); 
} 


正 向 定义 与 反 向 定义 不 同 的 是 多 了 一 个 参数 relation ， 这 个 参数 默认 值 是 从 
debug backtrace 函数 获取 的 : 


protected function guessBelongsToRelation() 


{ 
list($one, $two, $caller) = debug_backtrace(DEBUG_BACKTRACE_ 
IGNORE_ARGS, 3); 


return $caller['function']; 


也 就 是 我 们 的 关联 函数 名 user ， belongsTo HAAK XK HEC TES XXL 
保存 起 来 。 


另 一 个 不 同 是 外 键 的 默认 名 称 ， 不 再 是 类 名 + 主键 名 ， 而 是 关联 名 + 主键 名 : 
if (is null($foreignKey)) { 
$foreignKey = Str::snake($relation).' '.$instance-»getKeyNam 


e(); 
} 


我 们 接着 看 belongsTo 函数 : 


public function __construct(Builder $query, Model $child, $forei 
gnKey, $ownerKey, $relation) 


{ 
$this->ownerKey = $ownerKey; 
$this->relation = $relation; 
$this->foreignKkey = $foreignKkey; 
$this->child = $child; 
parent::__construct($query, $child); 
} 


我 们 可 以 看 出 来 ， 相 对 于 正 向 关联 ， 反 向 关联 除了 保存 外 键 名 与 主键 名 之 外 ， 还 保 
存 了 关系 名 、 子 模型 。 值 得 注意 的 是 ， 反 向 关联 中 related 代表 父 模 
型 ， parent 代表 子 模型 ， 与 正 向 关联 相反 。 


hasMany 的 模型 关系 如 下 : 
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约束 条 件 也 相应 地 进行 反 转 改变 : 


public function addConstraints() 


{ 
if (static::$constraints) { 
$table = $this->related->getTable(); 
$this->query->where($table.'.'.$this->ownerKkey, '-', $th 
is->child->{$this->foreignKkey}); 
} 
} 
限制 条 件 : 


select user where user.id = 1 (post.user_id) 


belongsMany 多 对 多 


多 对 多 关系 由 于 中 间 表 的 原因 相对 来 说 比较 复杂 ， 涉 及 的 参数 也 非常 多 。 我 们 以 官 
网 例子 : 


444 


class User extends Model 


{ 
/ 大 类 
* 获得 此 用 户 的 角色 。 
od 
public function roles() 


1 


return $this->belongsToMany('App\Role', 'role user', 'us 
er id', 'role- id'); 


} 


User 表 与 role 表 是 多 对 多 关系 ， 另 外 有 一 中 间 表 user role 表 ， 我 们 在 
定义 关系 的 时 候 ， related 是 被 关联 模型 ， table 是 中 间 

表 ， foreignPivotKey 是 中 间 表 中 父 模型 外 键 名 ， relatedPivotKey 是 中 间 
表 中 子 模型 外 键 名 ， parentKey 是 父 模型 主键 名 ， relatedKey 是 子 模型 主键 


Z> relation 是 关系 名 。 


public function belongsToMany($related, $table = null, $foreignP 
ivotKey = null, $relatedPivotKey = null, $parentKey = null, $rel 
atedKey = null, $relation = null) 


{ 
if (is_null($relation)) { 
$relation = $this->guessBelongsToManyRelation(); 


$instance = $this->newRelatedInstance($related) ; 


$foreignPivotKey = $foreignPivotKey ?: $this->getForeignKey( 
); 


$relatedPivotKey - $relatedPivotKey ?: $instance-»getForeign 
Key(); 


if (is null($table)) { 
$table = $this->joiningTable($related) ; 


return new BelongsToMany( 
$instance->newQuery(), $this, $table, $foreignPivotKey, 
$relatedPivotKey, $parentKey ?: $this->getKeyName(), 
$relatedKey ?: $instance->getKeyName(), $relation 


): 


获取 关联 名 称 仍 然 使 用 的 是 debug_backtrace 函数， 不同 

于 guessBelongsToRelation 函数 只 有 belongsTo WAM, 
guessBelongsToManyRelation 函数 还 可 以 被 morphedByMany HAAA > Af 
以 不 能 单纯 的 限制 返回 堆栈 帧 : 


public static $manyMethods = [ 
'belongsToMany', 'morphToMany', 'morphedByMany', 
'guessBelongsToManyRelation', 'findFirstMethodThatIsntRelati 
on', 


]; 


protected function guessBelongsToManyRelation() 


{ 
$caller = Arr::first(debug_backtrace(DEBUG_BACKTRACE_IGNORE 
ARGS), function ($trace) { 
return ! in_array($trace['function'], Model: :$manyMethod 


8); 


3); 


return ! is null($caller) ? $caller['function'] : null; 


黑 认 的 中 间 表 是 两 个 表 名 的 蛇 形 变量 : 


public function joiningTable($related) 


{ 
$models = [ 
Str: :snake(class_basename($related)), 
Str: :snake(class_basename($this)), 
l; 
sort($models); 
return strtolower(implode(' ', $models)); 
} 


BelongsToMany 的 初始 化 也 需要 保存 这 些 变量 : 
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public function __construct(Builder $query, Model $parent, $tabl 
e, $foreignPivotKey, 
$relatedPivotKey, $parentKey, $r 

elatedKey, $relationName = null) 
if 

$this->table = $table; 

$this->parentKey = $parentKey; 

$this->relatedKey = $relatedKey; 

$this->relationName = $relationName; 

$this->relatedPivotKey = $relatedPivotKey; 

$this->foreignPivotKey = $foreignPivotKey; 


parent::__construct($query, $parent); 


belongsToMany 的 模型 关系 如 下 : 





反 向 的 多 对 多 模型 关系 : 


448 
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限制 条 件 : 


449 


public function addConstraints() 


1 
$this->performJoin(); 
if (static::$constraints) { 
$this->addwhereConstraints(); 
} 
} 


protected function performJoin($query = null) 
{ 
$query = $query ?: $this->query; 
$baseTable = $this-»related-»getTable(); 


$key = $baseTable.'.'.$this->relatedKey; 


$query->join($this->table, $key, '-', $this->getQualifiedRel 
atedPivotKeyName()); 


return $this; 


protected function addWhereConstraints() 


{ 
$this->query ->where( 
$this->getQualifiedForeignPivotKeyName(), '-', $this->pa 
rent->{$this->parentKey} 
); 


return $this; 


本 例 中 的 where 条 件 : 


select role join role_user on role_user.role_id = 1 (role.id) 


select role where role_user.user_id = 1 (user.id) 


hasManyThrough 远程 一 对 多 


远 层 一 对 多 关联 提供 了 方便 、 简 短 的 方式 通过 中 间 的 关联 来 获得 远 层 的 关联 。 以 官 
方 例 子 来 看 : 


class Country extends Model 
{ 
public function posts() 
{ 
return $this->hasManyThrough( 
'AppNPost', 
'AppNUser', 
country sirdi sans ue 
MIS Cia ens fe ee 
'id', // 国家 表 本 地 键 .. 
'id' // 用 户 表 本 地 键 ,.. 


); 


可 以 看 到 ， 远 程 一 对 多 的 参数 比较 多 。 第 一 个 参数 related 是 最 终 被 关联 的 模 
Al > through 是 中 间 模 型 firstKey 是 中 间 模 型 关于 父 模型 的 外 

键 ，secondKey 是 最 终 被 关联 的 模型 关于 中 间 模 型 的 外 键 ， LocalKey 是 父 模 
型 的 主键 ， secondLocalKey 是 中 间 模 型 的 主键 : 


public function hasManyThrough($related, $through, $firstKey = n 
ull, $secondKey = null, $localKey = null, $secondLocalKey = null) 


$through = new $through; 


$firstKey = $firstKey ?: $this->getForeignKkey(); 


$secondKey = $secondKey ?: $through-»getForeignKey(); 


$1ocalKey = $localKey ?: $this-»getKeyName(); 


$secondLocalKey = $secondLocalKey ?: $through-»getKeyName(); 


$instance = $this->newRelatedInstance($related) ; 


return new HasManyThrough($instance->newQuery(), $this, $thr 


ough, $firstKey, $secondKey, $localKey, $secondLocalKey); 


} 


ee 4) 


HasManyThrough 的 初始 化 : 


public function — construct(Builder $query, Model $farParent, Mo 
del $throughParent, $firstKey, $secondKey, $localKey, $secondLoc 
alKey) 


{ 


$this->localKey = $1ocalkey; 
$this->firstKey = $firstKey; 
$this->secondKey = $secondKey; 
$this->farParent = $farParent; 
$this->throughParent = $throughParent; 
$this->secondLocalkey = $secondLocalkey; 


parent::__construct($query, $throughParent) ; 


hasManyThrough 的 模型 关系 如 下 : 





country_name 





限制 条 件 : 


public function addConstraints() 


{ 
$localValue = $this->farParent[$this->localkey]; 


$this->performJoin(); 


if (static::$constraints) { 
$this->query->where($this->getQualifiedFirstKeyName(), ' 
=', $localValue); 
Jj; 


protected function performJoin(Builder $query - null) 


{ 
$query = $query ?: $this->query; 


$farKey = $this->getQualifiedFarKeyName(); 


$query->join($this->throughParent->getTable(), $this->getQua 
lifiedParentKeyName(), '-', $farKey); 


if ($this->throughParentSoftDeletes()) ( 
$query->whereNull($this->throughParent ->getQualifiedDele 
tedAtColumn()); 


j 


public function getQualifiedParentKeyName( ) 


{ 
return $this->parent->getTable().'.'.$this->secondLocalkey; 
j 
public function getQualifiedFarKeyName() 
{ 
return $this-»getQualifiedForeignKeyName(); 
} 
public function getQualifiedForeignKeyName() 
{ 
return $this->related->getTable().'.'.$this->secondKey; 
} 
public function getQualifiedFirstKeyName() 
{ 
return $this->throughParent->getTable().'.'.$this->firstKey; 
} 
本 例 中 的 限制 条 件 : 


select post join user on user.id = post.user_id 
select post where user.delete_at is null 


select post where user.country_id = 1 (country.id) 
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多 态 关 联 允 许 我 们 应 用 一 个 表 来 单独 作为 多 个 表 的 属性 ， 多 态 关联 存在 一 对 一 、 一 
对 多 、 多 对 多 的 情形 。 所 谓 一 对 一 、 一 对 多 是 指 ， 一 个 模型 只 拥有 一 个 属性 或 多 个 
属性 ， 例 如 官网 中 的 例子 : 


APTA TFE] 文章 和 视频 。 使 用 多 态 关 联 ， 您 可 以 用 一 个 comments KA 
时 满足 这 两 个 使 用 场景 


class Post extends Model 


{ 
7 k*k k 
* 获得 此 文章 的 所 有 评论 。 
by 
public function comments() 


{ 


return $this->morphMany('App\Comment', 'commentable'); 


class Video extends Model 


{ 
/ =x 
* 获得 此 视频 的 所 有 评论 。 
“A 
public function comments() 


( 


return $this->morphMany('App\Comment', 'commentable'); 


这 个 comments 表 就 是 属性 表 ， 当 文章 和 视频 只 能 有 一 个 评论 的 时 候 ， 那 么 就 是 
一 对 一 多 态 关联 ; 如 果 文 章 和 视频 可 以 由 多 个 评论 的 时 候 ， 就 是 一 对 多 多 态 关 联 。 


这 种 属性 表 一 般 会 有 两 个 固定 的 字段 : commentable type 用 于 标识 该 条 评论 是 
文章 的 还 是 视频 的 、 commentable id 用 于 记录 文章 或 视频 的 主键 id o 


我 们 可 以 把 多 态 关联 看 作 普通 的 一 对 一 、 一 对 多 关系 ， 只 是 外 键 参 数 是 type 5 


id 的 组 合 。 


related 是 属性 表 ， 也 就 是 这 里 的 comments ^ type 参数 是 属性 表 中 存储 父 
模型 类 型 的 列 名 (commentable type): id 参数 是 属性 表 中 存储 父 模型 主键 的 列 
名 (commentable id)， 而 name 专用 于 省 略 type 参数 与 id 参 
数 ， localkey 是 指 父 模型 的 主键 。 


public function morphOne($related, $name, $type = null, $id = nu 
ll, $localKey = null) 


i $instance = $this->newRelatedInstance($related); 
list($type, $id) = $this->getMorphs($name, $type, $id); 
$table = $instance->getTable(); 
$localKey = $localKey ?: $this->getKeyName(); 
return new MorphOne($instance->newQuery(), $this, $table.'.' 
.$type, $table.'.'.$id, $1ocalKey); 
j 


public function morphMany($related, $name, $type = null, $id =n 
ull, $localKey = null) 


{ 
$instance = $this->newRelatedInstance($related) ; 
list($type, $id) = $this->getMorphs($name, $type, $id); 
$table = $instance-»getTable(); 
$1ocalKey = $localKey ?: $this-»getKeyName(); 
return new MorphMany($instance-»newQuery(), $this, $table.'.' 
.$type, $table.'.'.$id, $localkey); 
} 
protected function getMorphs($name, $type, $id) 
{ 
return [$type ?: $name.' type', $id ?: $name.' id']; 
} 


B —————————— A54]: n 


一 对 一 、 一 对 多 多 态 关 联 主 要 保存 属性 表 中 表示 类 型 的 列 名 ， 还 有 需要 向 该 类 型 列 
中 写 入 的 父 模 型 名 称 ， 一 般 来 说 ， 默 认 会 写 父 模型 的 类 名 
( App\Post ^ App\Video ) 


public function __construct(Builder $query, Model $parent, $type 
, $id, $localKey) 


{ 
$this->morphType = $type; 
$this->morphClass = $parent->getMorphClass(); 
parent::__construct($query, $parent, $id, $localKey); 
} 


public function getMorphClass() 


{ 
$morphMap = Relation: :morphMap(); 


if (! empty($morphMap) && in_array(static::class, $morphMap) 
) { 


return array_search(static::class, $morphMap, true); 


return static::class; 


不 过 我 们 也 可 以 自 定义 写 入 的 值 : 


Relation: :morphMap([ 
'posts' => 'App\Post', 
'videos' => 'App\Video', 


]); 


这 样 ， 就 会 把 App\Post 换 成 posts * App\Video 换 成 videos 。 我 们 来 
看 看 这 个 SARHR BHR: 


public static function morphMap(array $map = null, $merge = true) 


{ 
$map = static::buildMorphMapFromModels($map) ; 
if (is_array($map)) { 
static::$morphMap = $merge && static::$morphMap 
? array_merge(static::$morphMap, $map) 
$map; 
} 
return static::$morphMap; 
} 
protected static function buildMorphMapFromModels(array $models 
= null) 
{ 
if (is_null($models) || Arr::isAssoc($models)) { 
return $models; 
} 
return array combine(array map(function ($model) { 
return (new $model)->getTable(); 
}, $models), $models); 
} 


eee 


可 以 看 到 ， buildMorphMapFromModels 函数 将 字符 串 App\Post 转 为 
model ， 并 利用 array combine 转 为 键 。 


morphone 的 模型 关系 如 下 : 
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morphMany 的 模型 关系 如 下 : 





限制 条 件 : 
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public function addConstraints() 


1 
if (static::$constraints) { 
parent: :addConstraints(); 
$this->query->where($this->morphType, $this->morphClass) 
} 
} 


public function addConstraints() 


( 


if (static::$constraints) { 
$this->query->where($this->foreignKkey, '-', $this->getPa 
rentKey()); 


$this->query->whereNotNull($this->foreignKkey) ; 


本 例 中 的 限制 条 件 : 


select comments where comment.commentable_id = post.id 
select comments where comment.commentable_id is not null 


select comments where comment.commentable type = 'App*Post' 


morphTo Km 2 A XJ 


和 一 对 一 、 一 对 多 的 belongsTo 相似 ， 多 态 关联 还 可 以 定义 反 向 关联 


morphTo : 


class Comment extends Model 


{ 
/** 
* 获得 拥有 此 评论 的 模型 。 
d 
public function commentable() 
{ 
return $this->morphTo(); 
} 
} 


与 belongsTo 类 似 ， morphTo 也 是 利用 debug backtrace 获取 关联 名 称 。 
当前 如 果 正 处 于 预 加 载 状 态 的 时 候 ， Comment 一般 还 没有 从 数据 库 获取 数 
Æ > $this->{$type} 是 空 值 ， 这 个 时 候 需 要 去 除 预 加 载 来 初始 化 : 


public function morphTo($name = null, $type = null, $id = null) 
{ 


$name = $name ?: $this->guessBelongsToRelation(); 


list($type, $id) = $this->getMorphs( 
Str::snake($name), $type, $id 
); 


return empty($class = $this->{$type}) 
? $this->morphEagerTo($name, $type, $id) 
: $this->morphInstanceTo($class, $name, $type, $ 
id); 
} 


protected function morphEagerTo($name, $type, $id) 


i 


return new MorphTo( 
$this->newQuery()->setEagerLoads([]), $this, $id, null, 
$type, $name 
); 


protected function morphInstanceTo($target, $name, $type, $id) 


{ 
$instance = $this->newRelatedInstance( 
static: :getActualClassNameForMorph($target ) 
); 


return new MorphTo( 
$instance->newQuery(), $this, $id, $instance->getKeyName 
(), $type, $name 
); 


多 态 的 成 员 变量 morphrype 代表 属性 表 的 类 型 列 ， morphClass 


MorphTo 的 成 员 变 量 只 有 一 个 morphType : 
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public function __construct(Builder $query, Model $parent, $fore 
ignKey, $ownerKey, $type, $relation) 


1 
$this->morphType = $type; 
parent::__construct($query, $parent, $foreignKey, $ownerKey, 
$relation); 
} 


morphTo 的 模型 关系 如 下 : 





限制 条 件 与 belongsTo 相同 : 
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public function addConstraints() 


1 
if (static::$constraints) ( 
$table = $this->related->getTable(); 
$this->query->where($table.'.'.$this->ownerKey, '-', $th 
is->child->{$this->foreignKkey}); 
} 
} 


本 例 中 的 限制 条 件 


select post where post.id = comments.commentable_id 


除了 传统 的 多 态 关联 ， 您 也 可 以 定义 「 多 对 多 」 的 多 态 关 联 。 例 如 ，Post 模型 和 
Video 模型 可 以 共享 一 个 多 态 关 联 至 Tag 模型 。 使 用 多 对 多 多 态 关 联 可 以 让 您 在 文 


章 和 视频 中 共享 唯一 的 标签 列表 。 


class Post extends Model 


{ 
/** 
* 获得 此 文章 的 所 有 标签 。 
uà 
public function tags() 
{ 
return $this->morphToMany('App\Tag', 'taggable'); 
j 
j 


多 对 多 多 态 关 联 与 多 对 多 关联 的 代码 类 似 ， 不 同 的 是 中 间 表 不 再 是 两 个 父 模 型 的 蛇 
FE’ ně name 的 复数 ， 值 得 注意 的 是 foreignPivotKey 代表 中 间 表 中 对 

当前 post 或 者 video 的 外 键 ， 一 般 会 放 在 taggable_id 字段 

中 ， relatedPivotKey 代表 中 间 表 中 对 属性 表 tag 的 外 键 tag_id : 


public function morphToMany($related, $name, $table = null, $for 
eignPivotKey = null, 

$relatedPivotKey = null, $parent 
Key = null, 

$relatedKey = null, $inverse = f 
alse) 


{ 


$caller = $this->guessBelongsToManyRelation(); 


$instance = $this->newRelatedInstance($related) ; 


$foreignPivotKey = $foreignPivotKey ?: $name.' id'; 


$relatedPivotKey - $relatedPivotKey ?: $instance-»getForeign 
Key(); 


$table - $table ?: Str::plural($name); 


return new MorphToMany( 
$instance->newQuery(), $this, $name, $table, 
$foreignPivotKey, $relatedPivotKey, $parentKey ?: $this- 
>getKeyName(), 
$relatedKey ?: $instance->getKeyName(), $caller, $invers 


); 


MorphToMany 的 构造 函数 依然 有 morphType 4 morphClass > morphType 
标识 着 当前 中 间 表 的 记录 类 型 是 Post ， 还 是 videos ^ morphClass 的 值 默 
认 值 是 Post 类 或 者 videos 的 全 名 ， 正 向 关联 的 时 候 ， inverse X 
false ， 反 向 关联 的 时 候 ，inverse Æ true ° 


public function __construct(Builder $query, Model $parent, $nam 
e, $table, $foreignPivotKey, 
$relatedPivotKey, $parentKey, $r 
elatedKey, $relationName = null, $inverse = false) 
if 
$this->inverse = $inverse; 
$this->morphType = $name.' type'; 
$this->morphClass = $inverse ? $query-»getModel()-»getMorphC 
lass() : $parent->getMorphClass(); 


parent: :__construct( 
$query, $parent, $table, $foreignPivotKey, 
$relatedPivotKey, $parentKey, $relatedKey, $relationName 


); 


正 向 关联 的 时 候 ， parent Ke Post 类 或 者 videos 类 ， 反 向 关联 的 时 候 
related 是 Post 类 或 者 videos 类 。 


限制 条 件 : 


protected function addWhereConstraints() 


( 


parent: :addwhereConstraints(); 


$this->query->where($this->table.'.'.$this->morphType, $this 
-»morphClass); 


return $this; 


protected function addWhereConstraints() 


{ 
$this->query ->where( 
$this->getQualifiedForeignPivotKeyName(), '-', $this->pa 
rent->{$this->parentKey} 
); 


return $this; 


public function getQualifiedForeignPivotKeyName( ) 


{ 


return $this->table.'.'.$this->foreignPivotkKey; 


官网 中 例子 限制 条 件 转化 为 sql (假设 Post 的 主键 为 1) : 
where taggables.taggable_id = 1; 


where taggables.taggable_type = 'App\Post' 


morphToMany 的 模型 关系 如 下 : 
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限制 条 件 : 


public function addConstraints() 


1 
$this->performJoin(); 
if (Static: -sconstraints) { 
$this->addwhereConstraints(); 
J 
} 


protected function performJoin($query = null) 
{ 
$query = $query ?: $this->query; 
$baseTable = $this->related->getTable(); 


$key = $baseTable.'.'.$this->relatedKey; 


$query->join($this->table, $key, '-', $this->getQualifiedRel 
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atedPivotKeyName()); 


return $this; 


protected function addWhereConstraints() 
{ 


parent: :addwhereConstraints(); 


$this->query->where($this->table.'.'.$this->morphType, $this 
-»morphClass); 


return $this; 


protected function addWhereConstraints() 


{ 
$this->query ->where( 
$this->getQualifiedForeignPivotKeyName(), '-', $this->pa 
rent->{$this->parentKey} 
); 


return $this; 


本 例 中 的 限制 条 件 : 
select tag join tagable on tagable.tag_id = tag.id 
select tags where tagable.tagables_id = post.id 


select tags where tagable.tagables type = 'AppNTag' 


多 对 多 多 态 反 向 关联 


官方 文档 例子 : 


class Tag extends Model 


1 
J** 
* 获得 此 标签 下 所 有 的 文章 。 
2 
public function posts() 
{ 
return $this->morphedByMany('App\Post', 'taggable'); 
} 
} 


与 正 向 关联 相反 ， relatedPivotKey 代表 中 间 表 中 对 related 表 post 或 
者 video 的 外 键 ， 一 般 会 放 在 taggable id 字段 中 ， foreignPivotKey 代 
表 中 间 表 中 对 当前 属性 表 tag 的 外 键 tag_id 


public function morphedByMany($related, $name, $table = null, $f 
oreignPivotKey = null, 

$relatedPivotKey = null, $pare 
ntKey = null, $relatedKey = null) 


{ 
$foreignPivotKey = $foreignPivotKey ?: $this-»getForeignKey( 
); 
$relatedPivotKey - $relatedPivotKey ?: $name.' id'; 
return $this->morphToMany( 
$related, $name, $table, $foreignPivotKey, 
$relatedPivotKey, $parentKey, $relatedKey, true 
); 
} 


官网 中 例子 限制 条 件 转化 为 sql (假设 Tag 的 主键 为 1) : 
where taggables.tag_id = 1; 


where taggables.taggable type = 'App\Post' 
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morphedByMany 的 模型 关系 如 下 : 


taggable id 





限制 条 件 与 morphToMany 一 致 : 


public function addConstraints() 


{ 
$this->performJoin(); 
if (static::$constraints) { 
$this->addwhereConstraints(); 
} 
} 


protected function performJoin($query = null) 
{ 
$query = $query ?: $this->query; 
$baseTable = $this->related->getTable(); 


$key = $baseTable.'.'.$this->relatedKey; 


$query->join($this->table, $key, '-', $this->getQualifiedRel 
atedPivotKeyName()); 


return $this; 
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protected function addWhereConstraints() 
{ 


parent: :addWhereConstraints(); 


$this->query->where($this->table.'.'.$this->morphType, $this 
-»morphClass); 


return $this; 


protected function addWhereConstraints() 


{ 
$this->query ->where( 
$this->getQualifiedForeignPivotKeyName(), '-', $this->pa 
rent->{$this->parentKey} 
); 


return $this; 


本 例 中 的 限制 条 件 


select post join post on post.id = tagables.tagable_id 


select post where tagables.tag_id = tag.id 


select post where tagables.tagable type = 'App\Post' 
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关系 加 载 与 查询 


fan] 
a 
PUT 


我 们 在 上 一 篇 文章 中 介绍 了 模型 关系 的 定义 初始 化 ， 我 们 可 以 看 到 ， 在 初始 化 的 过 
程 中 laravel 已 经 为 各 种 关联 关系 的 模型 预先 插入 了 初始 的 where 条件。 本 
文 将 会 进一步 介绍 如 何 添加 自 定义 的 查询 条 件 ， 如 何 加 载 、 预 加 载 关联 模型 。 


关联 模型 的 加 载 
当 我 们 定义 关联 模型 后 : 


class User extends Model 


{ 
public function phone() 
{ 
$this->hasOne('App\Phone', 'user id', 'id'); 
} 
} 


我 们 可 以 像 成 员 变 量 一 样 来 获取 与 之 关联 的 模型 : 
$user = App\User::find(1); 


foreach ($user->posts as $post) { 
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j 


实际 上 ， 模 型 的 属性 获取 函数 的 确 可 以 加 载 关 联 模型 : 


public function getAttribute( $key ) 


1 
if (! $key) { 
return， 
return $this->getRelationValue($key); 
jy 


getRelationValue 函数 专用 于 加 载 我 们 之 前 定义 的 关联 模型 : 


public function getRelationValue($key ) 


{ 
if ($this->relationLoaded($key)) ( 
return $this->relations[$key]; 
} 
if (method_exists($this, $key)) { 
return $this->getRelationshipFromMethod($key) ; 
} 
} 
public function relationLoaded($key) 
{ 
return array_key_exists($key, $this->relations); 
} 


可 以 看 到 ， 关 联 的 加 载 带 有 缓存 ， laravel 首先 会 验证 当前 关联 关系 是 否 已 经 被 
加 载 ， 如 果 加 载 过 ， 那 么 直接 返回 缓存 结果 。 


protected function getRelationshipFromMethod(S$method) 


1 
$relation = $this->$method(); 


if (! $relation instanceof Relation) { 
throw new LogicException(get class($this).'::'.$method.' 
must return a relationship instance.'); 


j 


return tap($relation->getResults(), function ($results) use 
($method) { 
$this->setRelation($method, $results); 


3); 


当 我 们 调用 $user-»posts 语句 的 时 候 ， laravel 会 调用 posts Hh? BH 
数 开始 定义 关联 关系 ， 并 且 返 回 hasOne 对 象 ， 在 这 里 将 会 调用 getResults 
子 数 来 加 载 关 联 模型 : 


public function getResults() 


{ 

return $this->query->first() ?: $this->getDefaultFor($this-> 
parent); 
j 


getDefaultFor HAA TAE REW £L ETT ARRAN NHL RAE ELAK 
时 候 ， 可 以 提供 默认 的 方法 来 控制 返回 的 结果 : 


public function user() 


return $this->belongsTo( 'App\User' )->withDefault(); 
} 
public function user() 
{ 
return $this->belongsTo( 'App\User' )->withDefault([ 
'name' => ' 游 客 '， 
1); 
} 
public function user() 
{ 
return $this->belongsTo('App\User')->withDefault(function ($ 
user) { 
$user->name = “游客 ' ， 
3); 
} 


withDefault 可 以 提供 空 值 、 数 组 、 闭 包 函 数 等 等 选项 ， getDefaultFor $ 
数 在 关联 没有 查询 到 结果 的 时 候 ， 按 要 求 返 回 一 个 模型 : 


public function withDefault($callback = true) 


{ 
$this->withDefault = $callback; 


return $this; 


protected function getDefaultFor(Model $parent ) 


t 
if (! $this->withDefault) { 
return; 


$instance = $this->newRelatedInstanceFor($parent); 
if (is_callable($this->withDefault)) { 


return call_user_func($this->withDefault, $instance) ?: 
$instance; 


} 


if (is_array($this->withDefault)) { 
$instance->forceFill($this->withDefault); 


return $instance; 


获取 到 关联 模型 后 ， 就 要 放 入 缓存 当中 ， 以 备 后 续 情况 使 用 : 


public function setRelation($relation, $value) 
{ 


$this->relations[$relation] = $value; 


return $this; 


多 对 多 关系 的 加 载 


多 对 多 关系 的 加 载 与 一 对 多 等 关系 的 加 载 有 所 不 同 ， 原 因 是 不 仅 要 加 载 related 
模型 ， 还 要 加 载 中 间 表 模型 : 


public function getResults() 


{ 
return $this->get(); 
} 
public function get($columns = ['*']) 
{ 
$columns = $this->query->getQuery()->columns ? [] : $columns 
$builder = $this->query->applyScopes(); 
$models = $builder->addSelect ( 
$this->shouldSelect($columns ) 
)->getModels(); 
$this->hydratePivotRelation($models) ; 
if (count($models) > 0) ( 
$models = $builder->eagerLoadRelations($models) ; 
} 
return $this->related->newCollection($models); 
} 


shouldSelect 函数 加 载 了 中 间 表 的 字段 属性 : 


protected function shouldSelect(array $columns = ['*']) 


{ 
if ($columns == ['*']) { 
$columns = [$this->related->getTable().'.*']; 


return array_merge($columns, $this->aliasedPivotColumns()); 


protected function aliasedPivotColumns() 


{ 
$defaults = [$this->foreignPivotKey, $this->relatedPivotKey ] 


return collect(array_merge($defaults, $this->pivotColumns) ) - 
>map(function ($column) { 
return $this->table.'.'.$column.' as pivot_'.$column; 
})->unique()->all(); 


可 以 看 到 ， 这 个 时 候 ， 中 间 表 的 属性 会 被 放 入 related 模型 中 ， 并 且 会 被 赋予 别 


名 前 级 pivot ° 


接着 hydratePivotRelation 会 将 这 些 中 间 表 属性 加 载 到 中 间 表 模型 中 : 


protected function hydratePivotRelation(array $models) 


{ 
foreach ($models as $model) { 
$model->setRelation($this->accessor, $this->newExistingP 
ivot ( 
$this->migratePivotAttributes($model) 
)); 


protected function migratePivotAttributes(Model $model) 
{ 
$values = []; 
foreach ($model->getAttributes() as $key => $value) { 
if (strpos($key, 'pivot_') === 0) { 
$values[substr($key, 6)] = $value; 


unset ($model->$key); 


return $values; 


accessor 默认 值 为 pivot ， 我 们 也 可 以 在 定义 多 对 多 的 时 候 使 用 as BAA 
它 取 别名 : 


return $this->belongsToMany('App\Role')->as(‘role_user’); 


源码 : 


public function as($accessor ) 
1 


$this->accessor = $accessor; 


return $this; 


关联 模型 的 预 加 载 


with £x 


当 作 为 属性 访问 Eloquent 关联 时 ， 关 联 数据 是 「 懒 加 载 」 的 。 意 味 着 在 你 第 一 次 
访问 该 属性 时 ， 才 会 加 载 关联 数据 。 不 过 ， 当 你 查询 父 模型 时 ，Eloquent 还 可 以 进 
行 [ 预 加 载 ] 关联 数据 。 预 加 载 避 免 了 N+1 查询 问题 。 


预 加 载 可 以 一 次 操作 中 预 加 载 关联 模型 并 且 自 定义 用 于 select 的 列 ， 可 以 预 加 
载 几 个 不 同 的 关联 ， 还 可 以 预 加 载 吝 套 关联 ， 预 加 载 关联 数据 的 时 候 ， 为 查询 指定 
额外 的 约束 条 件 : 

$books = App\Book: :with(['author:id,name'])->get(); 

$books = App\Book::with(['author', 'publisher'])->get(); 

$books = App\Book: :with('author.contacts')->get(); 

$users = AppNUser::with(['posts' => function ($query) { 


$query->where('title', 'like', '%first%'); 
}])->get(); 


我 们 来 看 看 with A: 


public static function with($relations) 


{ 
return (new static) ->newQuery( )->with( 
is_string($relations) ? func_get_args() : $relations 


); 


预 加 载 调用 Eloquent/builder 的 with 函数 : 
public function with($relations) 


{ 


$eagerLoad = $this->parseWwithRelations(is_string($relations) 
? func_get_args() : $relations); 


$this->eagerLoad = array_merge($this->eagerLoad, $eagerLoad) 


return $this; 


eagerLoad 成 员 变 量 用 于 存放 预 加 载 的 关联 关系 ， parsewithRelations 用 于 
解析 关联 关系 : 


protected function parseWithRelations(array $relations) 


{ 
$results = []; 


foreach ($relations as $name => $constraints) { 
if (is_numeric($name)) { 


$name = $constraints; 


list($name, $constraints) = Str::contains($name, ':' 


) 
? $this->createSelectWithConstraint($nam 
e) 
[$name, function () { 
He, 
il 
} 
$results = $this->addNestedwiths($name, $results); 
$results[$name] = $constraints; 
J 
return $results; 
} 


当 我 们 在 模型 关系 中 写 入 : 符合 的 时 候 ， 说 明 我 们 不 想 select * ， 而 是 想 要 
只 查询 特定 的 字段 ， createSelectwithConstraint : 


protected function createSelectWithConstraint ($name) 


{ 


return [explode(':', $name)[0], function ($query) use ($name) 


$query->select(explode(',', explode(':', $name)[1])); 
3l; 
p 


E = = sj 





也 就 是 为 关联 关系 添加 select 条 件 。 


SRN MEMITRERWQMN IR €XgEXAEKEXATET 
> addNestedWiths 


protected function addNestedwiths($name, $results) 


{ 


$progress = []; 


foreach (explode('.', $name) as $segment) { 
$progress[] = $segment; 


if (! isset($results[$last = implode('.', $progress)])) 


{ 
$results[$last] = function () { 
fe 
J; 
} 
} 
return $results; 
} 


可 以 看 到 ， addNestedwiths 为 吝 套 的 模型 关系 赋予 默认 的 空 闭 包 函数 ， 例 如 
a.b.c * addNestedwiths 返回 的 results 数组 中 会 有 三 个 成 员 : 

a ^ a.b ^ a.b.c ， 这 三 个 变量 的 闭 包 函数 都 是 空 。 

427 > parsewithRelations 为 a.b.c 的 闭 包 函数 重新 典 值 ， 将 用 户 定 义 的 
约束 条 件 赋 子 给 a.b.c œ 


get 函数 预 加 载 


with 3A laravel 提供 了 需要 预 加 载 的 关联 关系 ， get 函数 在 从 数据 库 
中 获取 父 模型 的 数据 后 ， 会 将 需要 预 加载 的 模型 也 一 并 取出 来 : 


public function get($columns = ['*']) 


{ 
$builder = $this-»applyScopes(); 
if (count($models = $builder->getModels($columns)) > 9) { 
$models = $builder->eagerLoadRelations($models) ; 
} 
return $builder-»getModel()-»newCollection($models); 
} 


顾名思义 ”eagerLoadRelations 函数 就 是 获取 预 加 载 模型 的 的 函数 : 


public function eagerLoadRelations(array $models) 


l 


foreach ($this->eagerLoad as $name => $constraints) { 
// For nested eager loads we'll skip loading them here a 


nd they will be set as an 
// eager load on the query to retrieve the relation so t 


hat they will be eager 
// loaded on that query, because that is where they get 


hydrated as models. 
if (strpos($name, '.') === false) { 
$models = $this->eagerLoadRelation($models, $name, $ 


constraints); 


} 


return $models; 


在 这 里 ， 很 让 人 费解 的 是 if Abo mE AAREERT RAM WRK 
系 。 例 如 上 面 的 a.b.c * eagerLoadRelations 只 会 加 载 a 这 个 关联 关系 。 
其 实 原因 是 : 

// For nested eager loads we'll skip loading them here and they will be set as 


an eager load on the query to retrieve the relation so that they will be eager 
loaded on that query, because that is where they get hydrated as models. 


翻译 过 see ， Edd XE — Xo XS—XRded a ， 获 得 了 a 
关联 模型 之 后 ， 第 二 次 再 加 载 b ， 最 后 加 载 c 。 这 里 看 不 懂 没 关系 ， 答 案 在 下 
nn : 


protected function eagerLoadRelation(array $models, $name, Closu 
re $constraints) 


{ 


$relation = $this->getRelation($name); 
$relation->addEagerConstraints($models); 
$constraints($relation); 


return $relation->match( 
$relation->initRelation($models, $name), 
$relation->getEager(), $name 


); 


eagerLoadRelation 是 预 加 载 关联 关系 的 核心 ， 我 们 可 以 看 到 加 载 关 联 模 型 关 
系 主 要 有 四 个 步骤 : 


e 通过 关系 名 来 调用 hasone 等 函数 来 加 载 模型 关系 relation 

e 利用 models 来 为 模型 关系 添加 约束 条 件 

e 调用 with 函数 附带 的 约束 条 件 

e 从 数据 库 获 取 关 联 模 型 并 匹配 到 各 个 父 模型 中 ， 作 为 父 模型 的 属性 


我 们 先 从 调用 关联 函数 getRelation 来 说 : 


getRelation 


public function getRelation($name) 


( 


$relation - Relation::noConstraints(function () use ($name) 


ery t 
return $this->getModel()->{$name}(); 
) catch (BadMethodCallException $e) { 
throw RelationNotFoundException: :make($this->getMode 
1(), $name); 


} 
3): 


$nested = $this->relationsNestedUnder ($name) ; 


if (count($nested) > 0) { 
$relation->getQuery( )->with($nested); 


return $relation; 


我 们 在 上 一 个 文章 说 过 ， hasone 等 函数 会 自动 加 约束 条 件 例如 : 


select phone where phone.user_id = user.id 


但 是 这 个 约束 条 件 并 不 适用 于 预 加 载 ， 因 为 预 加 载 的 父 模 型 通常 不 只 只 一 个 。 因 此 
需要 调用 有 函数 noConstraints 来 避免 加 载 约束 条 件 : 


public static function noConstraints(Closure $callback) 
{ 
$previous = static::$constraints; 


static::$constraints = false; 


try 7 

return call user func($callback); 
) finally ( 

static::$constraints = $previous; 


接 下 来 ， 就 要 调用 定义 关联 的 函数 : 


return $this->getModel()->{$name}(); 


Fmt relationsNestedUnder 函数 用 于 加 载 谋 套 的 预 加 载 关联 关系 : 


protected function relationsNestedUnder ($relation) 


{ 
$nested = []; 


foreach ($this->eagerLoad as $name => $constraints) { 
if ($this->isNestedUnder($relation, $name)) { 


$nested[substr($name, strlen($relation.'.'))] = $con 


straints; 


} 


return $nested; 


protected function isNestedUnder($relation, $name) 


i 


return Str::contains($name, '.') && Str::startswWith($name, $ 


relation.'.'); 


} 


从 代码 上 可 以 看 出 来 ， 如 果 当 前 的 模型 关系 是 a ， relationsNestedUnder 
数 会 把 其 瞬 套 的 关系 都 检测 出 来 : a.b > a.b.c ， 并 且 放 入 nested 数组 
T : nested[b]、nested[b.c] ° 


接 下 来 : 


if (count($nested) > 0) { 
$relation->getQuery( )->with($nested) ; 


就 会 继续 递归 预 加 载 关联 关系 。 


关联 关系 预 加 载 约束 条 件 


获得 关联 关系 之 后 ， 就 要 加 载 各 个 关联 关系 自己 的 预 加 载 约束 条 件 : 


Xs 


public function addEagerConstraints(array $models) 


{ 
$this->query->whereIn( 
$this->foreignKey, $this->getKeys($models, $this->localk 


也 就 是 从 父 模 型 的 外 键 来 为 关联 模型 添加 where 条件。 当然 各 个 关联 关系 不 同 ， 
这 个 函数 也 有 一 定 的 区 别 。 


with fi we RA AE 
接 下 来 还 有 加 载 with 函数 的 约束 条 件 : 


$constraints($relation); 


匹配 父 模 型 
当 关 联 关系 的 约束 条 件 都 设置 完毕 后 ， 就 要 从 数据 库 中 来 获取 关联 模型 : 
$relation->match( 


$relation->initRelation($models, $name), 
$relation->getEager(), $name 


); 
public function getEager() 
{ 
return $this->get(); 
} 


initRelation 会 为 父 模 型 设置 默认 的 关联 模型 : 


public function initRelation(array $models, $relation) 


{ 
foreach ($models as $model) { 


$model->setRelation($relation, $this->getDefaultFor ($mod 
el)); 
J 


return $models; 


两 步 都 做 好 了 ， 接 下 来 就 要 为 父 模 型 和 子 模型 进行 匹配 了 : 


public function match(array $models, Collection $results, $relat 
ion) 
{ 


return $this->matchOne($models, $results, $relation); 


public function matchOne(array $models, Collection $results, $re 
lation) 
{ 

return $this->matchOneOrMany($models, $results, $relation, ' 
one'); 


} 


protected function matchOneOrMany(array $models, Collection $res 
ults, $relation, $type) 
{ 


$dictionary = $this->buildDictionary($results); 


foreach ($models as $model) { 
if (isset($dictionary[$key = $model->getAttribute($this- 
>localkey)])) { 
$model->setRelation( 
$relation, $this->getRelationValue($dictionary, 
$key, $type) 
); 


return $models; 


匹配 的 过 程 分 为 两 步 : 创建 目录 buildDictionary 和 设置 子 模型 


setRelation 


protected function buildDictionary(Collection $results) 


{ 
$dictionary = []; 


$foreign = $this->getForeignKkKeyName(); 


foreach ($results as $result) ( 
$dictionary[$result->{$foreign}][] = $result; 


return $dictionary; 


创建 目录 buildDictionary 函数 根据 子 模型 的 外 键 foreign 将 子 模型 进行 分 
类 ， 拥 有 同一 外 键 的 子 模型 放 入 同一 个 数组 中 。 


接 下 来 ， 为 父 模型 设置 子 模型 : 


foreach ($models as $model) { 
if (isset($dictionary[$key = $model->getAttribute($this->loc 
alkey)])) { 
$model->setRelation( 
$relation, $this->getRelationValue($dictionary, $key 
, $type) 
); 


protected function getRelationValue(array $dictionary, $key, $ty 
pe) 
{ 

$value = $dictionary[$key]; 


return $type == 'one' ? reset($value) : $this->related->newC 
ollection($value) ; 


} 


Ae Hk dictionary 中 存在 父 模型 的 主键 ， 就 会 从 目录 中 取出 对 应 的 子 模型 数 
组 ， 并 利用 setRelation Aree ZAE AKEH o 


关联 模型 的 关联 查询 


基于 存在 的 关联 查询 
官方 样 例 : 


// 获得 所 有 至 少 有 一 条 评论 的 文章 ., ， 
$posts = App\Post::has('comments')->get(); 


// RAMAR ERRERA ETCL... 
$posts = Post::has('comments', '>=', 3)->get(); 


// 获得 所 有 至 少 有 一 条 获 赞 评论 的 文章 , . ， 
$posts = Post::has('comments.votes')->get(); 


// 获得 所 有 至 少 有 一 条 评论 内 容 满足 foo% 条 件 的 文章 

$posts = Post::whereHas('comments', function ($query) { 
$query->where('content', 'like', 'foo%'); 

})->get(); 


has 六 数 用 于 基于 存在 的 关联 查询 : 


public function has($relation, $operator = '>=', $count = 1, $bo 
olean = 'and', Closure $callback = null) 


{ 
if (strpos($relation, '.') !== false) { 
return $this->hasNested($relation, $operator, $count, $b 
oolean, $callback); 


} 
$relation = $this->getRelationwithoutConstraints($relation); 


$method = $this->canUseExistsForExistenceCheck($operator, $c 
ount ) 
? 'getRelationExistenceQuery' 
'getRelationExistenceCountQuery'; 


$hasQuery = $relation->{$method} ( 
$relation->getRelated()->newQuery(), $this 
); 


if ($callback) ( 
$hasQuery-»callScope($callback); 


return $this->addHaswhere( 
$hasQuery, $relation, $operator, $count, $boolean 


); 


has 函数 的 步骤 : 


e 获取 无 约束 的 关联 关系 

e 为 关联 关系 添加 existence 约束 
e 为 关联 关系 添加 has 外 部 约束 

e 将 关联 关系 添加 到 where AHP 


无 约束 的 关联 关系 


protected function getRelationwithoutConstraints($relation) 


{ 
return Relation: :noConstraints(function () use ($relation) { 
return $this->getModel()->{$relation}(); 


3); 


这 个 不 用 多 说 ， 和 预 加 载 的 原理 一 样 。 


existence 7 


关系 模型 的 existence 约束 条 件 很 简单 : 


select * from post where user.id = post.user_id 


laravel 还 考虑 一 种 特殊 情况 ， 那 就 是 自己 关联 自己 ， 这 个 时 候 就 会 为 模型 命名 
一 个 新 的 _hash 


select * from user as wedfklk where user.id = wedfklk.foreignKey 


源 代码 比较 简单 : 


public function getRelationExistenceQuery(Builder $query, Builde 
r $parentQuery, $columns = ['*']) 
{ 
if ($query->getQuery()->from == $parentQuery->getQuery()->fr 
om) { 
return $this->getRelationExistenceQueryForSelfRelation($ 
query, $parentQuery, $columns); 


} 


return parent::getRelationExistenceQuery($query, $parentQuer 
y, $columns); 


j 


public function getRelationExistenceQueryForSelfRelation(Builder 
$query, Builder $parentQuery, $columns - ['*']) 


$query->from($query->getModel()->getTable().' as '.$hash = $ 
this->getRelationCountHash()); 


$query->getModel( )->setTable($hash); 


return $query->select($columns ) ->whereColumn( 
$this->getQualifiedParentKeyName(), '-', $hash.'.'.$this 
-»getForeignKeyName() 


): 


public function getRelationExistenceQuery(Builder $query, Builde 
r $parentQuery, $columns = ['*']) 
t 
return $query->select ($columns ) ->whereColumn( 
$this->getQualifiedParentKeyName(), '-', $this->getExist 
enceCompareKey( ) 


): 


} 
public function getExistenceCompareKey() 
{ 
return $this-»getQualifiedForeignKeyName(); 
} 


ExistenceCount 约束 


ExistenceCount 约束 只 是 select * $R select count(*) : 


select count(*) from post where user.id = post.user_id 


源 代 码 : 


public function getRelationExistenceCountQuery(Builder $query, B 
uilder $parentQuery) 


{ 


return $this-»getRelationExistenceQuery( 
$query, $parentQuery, new Expression('count(*)') 


); 


关联 关系 添加 到 where 条 件 


当 关 联 关系 的 存在 约束 设置 完毕 后 ， 就 要 加 载 到 父 模 型 的 where 条 件 中 ， 一 
投 会 作为 父 模 型 的 子 查询 : 


protected function addHasWhere(Builder $hasQuery, Relation $rela 
tion, $operator, $count, $boolean) 


{ 


$hasQuery->mergeConstraintsFrom($relation->getQuery()); 


return $this->canUseExistsForExistenceCheck($operator, $coun 
t) 
? $this->addwhereExistsQuery($hasQuery->toBase(), $b 
oolean, $operator === '«' && $count === 1) 
: $this->addwhereCountQuery($hasQuery->toBase(), $op 
erator, $count, $boolean); 


} 


public function addwhereExistsQuery(Builder $query, $boolean = ' 
and', $not = false) 


{ 
$type = $not ? 'NotExists' : 'Exists'; 


$this->wheres[] = compact('type', 'operator', 'query', ‘bool 
ean'); 


$this->addBinding($query->getBindings(), 'where'); 


return $this; 


} 

protected function addwhereCountQuery(QueryBuilder $query, $oper 
ator = '>=', $count = 1, $boolean = 'and') 

{ 


$this->query->addBinding($query->getBindings(), 'where'); 


return $this-»where( 
new Expression('('.$query->toSql().')'), 
$operator, 
is_numeric($count) ? new Expression($count) : $count, 
$boolean 


); 


existence 约束 最 后 条 件 : 


select * from user where exists (select * from phone where phone 
.user id-user.id) 


ExistenceCount 约束 


select * from user where (select count(*) from phone where phone 
.user id-user.id) »- 3 


KES 


RES ERB IRA has WA: 


protected function hasNested($relations, $operator = '>=', $coun 
t = 1, $boolean = 'and', $callback = null) 
t 


$relations = explode('.', $relations); 


$closure = function ($q) use (&$closure, &$relations, $opera 
tor, $count, $callback) { 
count($relations) > 1 
? $q->whereHas(array_shift($relations), $closure) 
: $q->has(array_shift($relations), $operator, $count 
, .and', $callback); 


i 


return $this->has(array_shift($relations), '>=', 1, $boolean 
, $closure); 


} 

public function whereHas($relation, Closure $callback = null, $0 
perator = '>=', $count = 1) 

{ 


return $this->has($relation, $operator, $count, 'and', $call 
back); 
} 


例如 


$posts = Post::has('comments.votes')->get(); 


首先 hasNested 会 返回 : 
$this--has('comments', '>=', 1, 'and', function ($q) use (&$clos 
ure, ‘votes’, '>=', 1, $callback) { 


$q->has(‘votes’, '>=', 1, 'and', $callback); 


); 
生成 的 sql: 


Select * from post where exist (select * from comment where comm 
ent.post id-post.id and where exist (select * from vote where vo 
te.comment id-comment.id)) 


基于 不 存在 的 关联 查询 


基于 不 存在 的 关联 查询 只 是 基于 存在 的 关联 查询 


public function doesntHave($relation, $boolean = 'and', Closure 
$callback - null) 
{ 


return $this->has($relation, '<', 1, $boolean, $callback); 


public function whereDoesntHave($relation, Closure $callback = n 
ull) 


{ 


return $this->doesntHave($relation, 'and', $callback); 


K HK BE TT AC 


Laravel Database——Eloquent Model 模型 关系 加 载 与 查询 


如 果 您 只 想 统 计 结 果 数 而 不 需要 加 载 实际 数据 ， 那 么 可 以 使 用 withCount 方法 ， 此 
方法 会 在 您 的 结果 集 模型 中 添加 一 个 { 关 联名 }_ count 字段 。 例 如 : 


$posts = App\Post: :withCount('comments')->get(); 
//select *,(select count(*) from comment where comment.post_id=p 
ost.id) as comments_count from post 


foreach ($posts as $post) { 
echo $post->comments_count; 


// 多 个 关联 数据 [计数] ， 并 为 其 查询 添加 约束 条 件 : 
$posts = Post::withCount(['votes', 'comments' => function ($quer 
y) { 

$query->where('content', 'like', 'foo%'); 
}])->get(); 
//select *, (select count(*) from comment where comment.post_id=p 
ost.id and content like 'foo%') as comments_count, (select count( 
*) from votes where vote.post_id=post.id) as votes_count from po 
st 


echo $posts[0]->votes_count; 
echo $posts[0]->comments_count; 


// 可 以 为 关联 数据 计数 结果 起 别名 ， 允 许 在 同一 个 关联 上 多 次 计数 : 
$posts = Post: :withCount([ 

'comments', 

‘comments as pending comments count' => function ($query) { 

$query->where('approved', false); 

} 
])->get(); 
//select *,(select count(*) from comment where comment.post_id=p 
ost.id) as comments count,(select count(*) from comment where co 
mment.post id-post.id and approved-false) as pending comments co 
unt from post 


echo $posts[9]-»comments count; 


echo $posts[9]-»pending comments count; 
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withCount 的 源 代码 与 has 的 代码 高 度 相似 : 


public function withCount($relations) 


i 


if (empty($relations)) { 


return $this; 


if (is_null($this->query->columns)) { 


$this->query->select([$this->query->from.'.*']); 


$relations = is_array($relations) ? $relations : func_get_ar 


gs(); 


foreach ($this->parsewithRelations($relations) as $name => $ 


constraints) { 


as') i 


$segments = explode(' ', $name); 


unset($alias); 


if (count($segments) == 3 && Str::lower($segments[i]) == 


list($name, $alias) = [$segments[0], $segments[2]]; 


$relation = $this-»getRelationwithoutConstraints($name); 


$query = $relation->getRelationExistenceCountQuery ( 
$relation->getRelated()->newQuery(), $this 
); 


$query->callScope($constraints); 


$query->mergeConstraintsFrom($relation->getQuery()); 


$column = $alias ?? Str::snake($name.' count'); 


$this->selectSub($query->toBase(), $column); 


return $this; 





e 解析 关联 关系 名 称 

e 获取 无 约束 的 关联 关系 

e 为 关联 关系 添加 existenceCount AR 
e 为 关联 关系 添加 with 外 部 约束 

e 将 关联 关系 添加 到 where AHP 

e 设置 alias 别名 

e 创建 select 子 查询 


多 对 乡 关系 的 中 间 表 查询 


return $this->belongsToMany('App\Role')->wherePivot('approved', 1 
); 


return $this->belongsToMany( 'App\Role')->wherePivotin('priority' 
; [1, 2]); 


[| 


public function wherePivot($column, $operator = null, $value = n 
ull, $boolean = 'and') 


{ 
$this->pivotwheres[] = func get args(); 
return $this->where($this->table.'.'.$column, $operator, $va 
lue, $boolean); 
} 
public function wherePivotIn($column, $values, $boolean = 'and', 
$not - false) 
{ 
$this->pivotwhereIns[] = func get args(); 
return $this->whereIn($this->table.'.'.$column, $values, $bo 
olean, $not); 
} 


注意 这 里 的 pivotwheres 4 pivotWheres 变量 ， 这 个 变量 在 对 中 间 表 的 加 载 
中 会 被 使 用 : 


protected function newPivotQuery() 


( 


$query = $this->newPivotStatement(); 


foreach ($this->pivotWheres as $arguments) { 
call_user_func_array([$query, 'where'], $arguments); 





foreach ($this->pivotWhereIns as $arguments) { 
call_user_func_array([$query, 'wherein'], $arguments); 





return $query->where($this->foreignPivotKey, $this->parent-> 
{$this->parentKey}); 
} 


Laravel Database——Eloquent Model 模型 关系 加 载 与 查询 
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Laravel Database——Eloquent Model 更 新 


关联 模型 
前 言 


在 前 两 篇 文章 中 ， 向 大 家 介绍 了 定义 关联 关系 的 源码 ， 还 有 基于 关联 关系 的 关联 模 
型 加 载 与 查询 的 源码 分 析 ， 本 文 开始 介绍 第 三 部 分 ， 如 何 利用 关联 关系 来 更 新 插入 
关联 模型 。 


hasOne/hasMany/MorphOne/MorphMany 更 新 
与 插入 


Save 方法 


正 向 的 一 对 一 、 一 对 多 关联 保存 方法 用 于 对 子 模型 设置 外 键 值 : 
public function save(Model $model) 
{ 


$this->setForeignAttributesForCreate($model) ; 


return $model->save() ? $model : false; 


protected function setForeignAttributesForCreate(Model $model) 
{ 
$model->setAttribute($this->getForeignKeyName(), $this->getP 
arentKey()); 
j 


public function getParentKey() 


{ 
return $this->parent->getAttribute($this->localkey) ; 


saveMany 方法 


public function saveMany($models) 


{ 
foreach ($models as $model) { 
$this->save($model); 
J 
return $models; 
J 


create 方法 


create 方法 与 save 方法 功能 一 致 ， 唯 一 不 同 的 是 create 的 参数 是 属 
性 ， save 方法 的 参数 是 model ° 


public function create(array $attributes = []) 


{ 


return tap($this->related->newInstance($attributes), function 
($instance) { 
$this->setForeignAttributesForCreate($instance) ; 


$instance->save(); 


3); 


protected function setForeignAttributesForCreate(Model $model) 


{ 
$model->setAttribute($this->getForeignKeyName(), $this->getP 


arentKey()); 
} 


= 


createMany 方法 


public function createMany(array $records) 


{ 
$instances = $this->related->newCollection(); 
foreach ($records as $record) { 
$instances->push($this->create($record) ); 
} 
return $instances; 
} 


make 方法 
make 方法 用 于 建立 子 模型 对 象 ， 但 是 并 不 进行 保存 操作 : 


public function make(array $attributes = []) 


{ 
return tap($this->related->newInstance($attributes), function 
($instance) { 


$this->setForeignAttributesForCreate($instance) ; 


3); 


update 方法 
update 方法 用 于 更 新 子 模型 的 属性 ， 值 得 注意 的 是 时 间 惟 的 更 新 : 


public function update(array $attributes) 
{ 
if ($this->related->usesTimestamps()) { 
$attributes[$this->relatedUpdatedAt()] = $this->related- 
>freshTimestampString(); 


} 


return $this-»query-»update($attributes); 


findOrNew 方法 


public function findOrNew($id, $columns = ['*']) 


1 
if (is null(S$instance = $this->find($id, $columns))) { 
$instance = $this-»related-»-newInstance(); 
$this->setForeignAttributesForCreate($instance) ; 
} 
return $instance; 
} 


firstOrCreate 方法 


实际 调用 的 是 create 方法 : 


public function firstOrCreate(array $attributes, array $values = 


inp 
{ 
if (is_null($instance = $this->where($attributes)->first())) 
{ 
$instance = $this->create($attributes + $values); 
J 
return $instance; 
} 


updateOrCreate 方法 


public function updateOrCreate(array $attributes, array $values 
zT 
{ 


return tap($this->firstOrNew($attributes), function ($instan 
ce) use ($values) { 
$instance-»fill($values); 


$instance-»save(); 


3): 


belongsTo/MorphTo 更 新 


save 方法 


如 果 我 们 在 子 模型 加 一 个 包含 关联 名 称 的 touches 属性 后 ， 当 我 们 更 新 一 个 子 模 
型 时 ， 对 应 父 模型 的 updated_at 字段 也 会 被 同时 更 新 : 


class Comment extends Model 


{ 
protected $touches = ['post']; 
public function post() 
{ 
return $this->belongsTo('App\Post'); 
} 
} 


$comment = App\Comment::find(1); 


$comment->text = ' 编 辑 了 这 条 评论 !'， 


$comment ->save(); 


这 是 由 于 ， 对 子 模型 调用 save 方法 会 引发 finishsave HA: 


protected function finishSave(array $options) 


{ 
$this->fireModelEvent('saved', false); 
if ($this->isDirty() && ($options['touch'] ?? true)) { 
$this->touchOwners(); 
} 
$this->syncOriginal(); 
} 


可 以 看 到 ， touchOwners 函数 被 调用 : 


public function touchOwners() 


{ 
foreach ($this->touches as $relation) { 
$this->$relation()->touch(); 
if ($this->$relation instanceof self) { 
$this->$relation->fireModelEvent('saved', false); 
$this->$relation->touchOwners(); 
} elseif ($this->$relation instanceof Collection) { 
$this->$relation->each(function (Model $relation) ( 
$relation-»touchOwners(); 
3); 
} 
} 
} 


可 以 看 到 ， touchOwners 函数 会 调用 touch 函数 ， 该 函数 用 于 更 新 父 模 型 的 
BR IR] EX : 


public function touch) 
{ 
$column = $this-»getRelated()-»getUpdatedAtColumn(); 


$this->rawUpdate([$column => $this->getRelated()->freshTimes 
tampString()]); 
} 


之 后 ， 父 模型 还 会 递归 调用 touchOowners 函数， 不断 更 新 上 一 级 的 父 模型 。 


Update 方法 
belongsTo/MorphTo 的 更 新 方法 用 于 父 模型 的 属性 更 新 : 


public function update(array $attributes) 


{ 
return $this->getResults()->fill($attributes) ->save(); 


associate 方法 


如 果 想 要 更 新 belongsTo 关联 时 ， 可 以 使 用 associate 方法 。 此 方法 会 在 子 
模型 中 设置 外 键 : 


public function associate($model) 


1 
$ownerKey = $model instanceof Model ? $model->getAttribute($ 


this->ownerKey) : $model; 
$this->child->setAttribute($this->foreignKkKey, $ownerKey); 
if ($model instanceof Model) { 


$this->child->setRelation($this->relation, $model); 


return $this-»child; 


dissociate 方法 


3 Ml belongsTo 关联 时 ， 可 以 使 用 dissociate 方 法 。 此 方法 会 设置 关联 外 键 为 
null : 


public function dissociate() 
{ 
$this->child->setAttribute($this->foreignkey, null); 


return $this->child->setRelation($this->relation, null); 


belongs ToMany/MorphToMany/MorphByMany 
更 新 与 插入 
attach 方法 


attach 方法 用 于 为 多 对 多 关系 添加 新 的 关联 关系 ， 主 要 进行 了 中 间 表 的 插入 工 
作 ， 用 法 : 


$user = App\User::find(1); 
$user ->roles()->attach($roleId); 


// 也 可 以 通过 传递 一 个 数组 参数 向 中 间 表 写 入 额外 数据 


$user->roles()->attach($roleId, ['expires' => $expires]); 


/7/ 为 了 方便 ”还 允许 传 六 ID 数组 : 
$user->roles()->attach([ 
1 => ['expires' => $expires], 
2 => ['expires' => $expires] 


1); 


源码 : 


public function attach($id, array $attributes = [], $touch = tru 
e) 
{ 
$this->newPivotStatement()->insert($this->formatAttachRecord 
s( 
$this->parseIds($id), $attributes 
)); 


if ($touch) ( 
$this-»touchIfTouching(); 


} 
} 
protected function parseIds($value) 
{ 
if ($value instanceof Model) { 
return [$value->getKey()]; 
} 
if ($value instanceof Collection) { 
return $value->modelKeys(); 
} 
if ($value instanceof BaseCollection) { 
return $value->toArray(); 
} 
return (array) $value; 
} 
public function newPivotStatement() 
{ 
return $this->query->getQuery( )->newQuery()->from($this->tab 
le); 
} 


可 以 看 到 ， attach 函数 最 重要 的 是 对 中 间 表 插入 新 数据 。 


在 说 这 段 代码 之 前 ， 我 们 要 先 说 说 多 对 多 关联 关系 独 有 的 设置 : 


P la] # Pivot 特殊 初始 化 设置 


e 自 定义 中 间 表 模型 


class Role extends Model 


{ 
jee 
* 获得 此 角色 下 的 用 户 。 
re 
public function users() 
{ 


return $this->belongsToMany( 'App\User' )->using( 'App\User 
Role'); 


} 


using 源码 非常 简单 : 


public function using($class) 


{ 


$this->using = $class; 


return $this; 


oP Al AY REC 


return $this->belongsToMany( 'App\Role' )->withTimestamps(); 


withTimestamps 源码 : 


public function withTimestamps($createdAt = null, $updatedAt = n 
ull) 


{ 
$this->pivotCreatedAt = $createdAt; 
$this->pivotUpdatedAt = $updatedAt; 
return $this->withPivot($this->createdAt(), $this->updatedAt 
0); 
} 
public function createdAt() 
{ 
return $this->pivotCreatedAt ?: $this->parent->getCreatedAtC 
olumn(); 
} 
public function updatedAt() 
{ 
return $this->pivotUpdatedAt ?: $this->parent->getUpdatedAtc 
olumn(); 
} 


e 中 间 表 自 定义 字段 


return $this->belongsToMany('App\Role')->withPivot('columní', 'c 
olumn2'); 


自 定义 字段 都 会 存放 在 pivotcolumns 中 : 


public function withPivot($columns) 
1 
$this->pivotColumns = array merge( 
$this->pivotColumns, is array($columns) ? $columns : fun 
c get args() 
); 


return $this; 


+ JR] 4 BY Tal EX 
我 们 接着 说 中 间 表 的 插入 代码 : 


protected function formatAttachRecords($ids, array $attributes) 


{ 


$records = []; 


$hasTimestamps = ($this->hasPivotColumn($this->createdAt()) 


| | 
$this->hasPivotColumn($this->updatedAt())); 


$attributes = $this->using 
? $this->newPivot()->forceFill($attributes) ->getAttr 
ibutes() 
: $attributes; 


foreach ($ids as $key => $value) ( 
$records[] = $this->formatAttachRecord( 
$key, $value, $attributes, $hasTimestamps 


); 


return $records; 


如 果 我 们 在 设置 多 对 多 关联 关系 的 时 候 ， 使 用 了 时 间 惟 ， 那 么 hasTimestamps 
就 会 为 true 。 


初始 化 Pivot 


当 我 们 设置 了 自 定义 的 中 间 表 模型 时 ， 就 会 调用 newPivot 函数 : 


public function newPivot(array $attributes = [], $exists = false) 


$pivot = $this->related->newPivot ( 
$this->parent, $attributes, $this->table, $exists, $this 
->using 


); 


return $pivot->setPivotKeys($this->foreignPivotKey, $this->r 
elatedPivotKey) ; 
} 


public function newPivot(Model $parent, array $attributes, $tabl 
e, $exists, $using = null) 
{ 
return $using ? $using::fromRawAttributes($parent, $attribut 
es, $table, $exists) 
: Pivot::fromAttributes($parent, $attributes, 
$table, $exists); 


} 
public function setPivotKeys($foreignKey, $relatedKey) 
{ 


$this->foreignKey = $foreignKey; 


$this-»relatedKey = $relatedKey; 


return $this; 


E mm + 


可 以 看 到 ， newPivot 会 返回 Pivot 类 型 的 对 象 ， 另 外 为 中 间 表 设置 了 
foreignKey 4 relatedKey 


生成 insert 数组 


protected function formatAttachRecord($key, $value, $attributes, 
$hasTimestamps ) 
{ 

list($id, $attributes) = $this->extractAttachIdAndAttributes 
($key, $value, $attributes); 


return array_merge( 
$this->baseAttachRecord($id, $hasTimestamps), $attribute 


); 


protected function extractAttachIdAndAttributes($key, $value, ar 
ray $attributes) 


{ 
return is_array($value) 
? [$key, array_merge($value, $attributes) ] 
[$value, $attributes]; 
} 


extractAttachIdAndAttributes 用 于 获得 插入 记录 的 主键 id ， 与 其 对 应 的 
属性 。 由 于 可 以 这 样 进行 传 入 参数 : 


$user->roles()->attach([ 
1 => ['expires' => $expires], 
2 => ['expires' => $expires] 


1); 


所 以 要 判断 一 下 value 是 否 是 数组 。 baseAttachRecord 最 终生 成 用 于 
insert 的 属性 数组 : 


protected function baseAttachRecord($id, $timed) 


{ 


$record[$this->relatedPivotKey ] $id; 


$record[$this->foreignPivotKey] = $this->parent->{$this->par 
entKey}; 


if ($timed) { 


$record = $this->addTimestampsToAttachment($record); 


return $record; 


protected function addTimestampsToAttachment(array $record, $exi 
sts = false) 


{ 
$fresh = $this->parent->freshTimestamp(); 
if (! $exists && $this->hasPivotColumn($this->createdAt())) 
t 
$record[$this->createdAt()] = $fresh; 
} 
if ($this->hasPivotColumn($this->updatedAt())) { 
$record[$this->updatedAt()] = $fresh; 
} 
return $record; 
} 
touchlfTouching 更 新 多 对 多 时 间 改 更 新 


对 中 间 表 进行 插入 操作 后 ， 就 要 对 父 模 型 与 related 模型 进行 时 间 改 更 新 操作 : 


public function touchIfTouching( ) 


{ 
if ($this->touchingParent()) { 
$this->getParent()->touch(); 
} 
if ($this->getParent()->touches($this->relationName)) { 
$this->touch(); 
} 
} 
public function touch() 
{ 
if (! $this->usesTimestamps()) { 
return false; 
} 
$this->updateTimestamps(); 
return $this->save(); 
} 


首先 ， 如 果 related 模型 的 touchis 数组 中 有 本 多 对 多 关系 ， 那 么 父 模型 就 要 
进行 时 间 惟 更 新 操作 : 


protected function touchingParent() 
{ 

return $this->getRelated()->touches($this->guessInverseRelat 
ion()); 


j 


protected function guessInverseRelation() 
{ 
return Str::camel(Str::plural(class_basename($this->getParen 
t()))); 
} 


其 次 ， 如 果 父 模型 的 touchs 数组 中 存在 多 对 多 关联 ， 那 么 就 要 进行 多 对 多 关联 
的 touch Až >? 3} related 模型 进行 时 间 惟 更 新 操作 : 


public function touch() 


{ 
$key = $this-»getRelated()-»getKeyName(); 


$columns = [ 
$this->related->getUpdatedAtColumn() => $this->related-> 
freshTimestampString(), 


1; 


if (count($ids = $this->allRelatedIds()) > 0) { 
$this->getRelated()->newQuery()->whereIn($key, $ids)-»up 
date($columns); 


} 
} 
public function allRelatedIds() 
{ 
return $this->newPivotQuery()->pluck($this->relatedPivotKey ) 
j 


save 方法 
belongsToMany 的 save 方法 用 于 更 新 多 对 多 关系 ， 该 函数 会 : 


e 更 新 related 模型 属性 
e 在 中 间 表 中 添加 新 的 记录 
e 更 新 父 模型 与 related 模型 的 时 间 惟 


主要 调用 了 attach AX : 


public function save(Model $model, array $pivotAttributes = [], 
$touch = true) 


{ 
$model->save(['touch' => false]); 
$this->attach($model->getKey(), $pivotAttributes, $touch); 
return $model; 

} 


saveMany 方法 


public function saveMany($models, array $pivotAttributes = []) 


{ 
foreach ($models as $key => $model) { 
$this->save($model, (array) ($pivotAttributes[$key] ?? [ 
]), false); 


} 


$this->touchIfTouching(); 


return $models; 


create 方法 


多 对 多 的 create 方法 用 于 保存 related 的 属性 ， 并 且 可 以 为 中 间 表 添加 
joining 属性 信息 : 


public function create(array $attributes = [], array $joining = 
[], $touch = true) 


{ 
$instance = $this->related->newInstance($attributes); 
$instance->save(['touch' => false]); 
$this->attach($instance->getKey(), $joining, $touch); 
return $instance; 

} 


createMany 方法 


public function createMany(array $records, array $joinings = []) 
{ 
$instances = []; 
foreach ($records as $key => $record) { 
$instances[] = $this->create($record, (array) ($joinings 
[$key] ?? []), false); 
} 


$this->touchIfTouching(); 


return $instances; 


detach 方法 


detach 方法 比较 简单 ， 重 要 的 是 对 中 间 表 进行 删除 操作 : 


public function detach($ids = null, $touch = true) 


{ 
$query = $this->newPivotQuery(); 


if (! is_null($ids)) { 
$ids = $this-»parseIds($ids); 


if (empty($ids)) { 
rete 


$query->whereIn($this->relatedPivotKey, 
$results = $query->delete(); 
if ($touch) { 


$this->touchIfTouching(); 


return $results; 


同步 关联 sync 


$user->roles()->sync([1, 2, 3]); 


// 可 以 通过 ID 传递 其 他 额外 的 数据 到 中 间 表 : 


(array) $ids); 


$user->roles()->sync([1 => ['expires' => true], 2, 3]); 


源码 : 


public function sync($ids, $detaching = true) 


1 
$changes - [ 
'attached' => [], 'detached' => [], 'updated' => [], 
]; 
$current = $this-»newPivotQuery()-»pluck( 
$this->relatedPivotKey 
)->all(); 
$detach = array_diff($current, array_keys( 
$records = $this->formatRecordsList($this->parselIds($ids 
)) 
)); 
if ($detaching && count($detach) > 0) { 
$this->detach($detach) ; 
$changes['detached'] = $this->castKeys($detach); 
} 
$changes = array_merge( 
$changes, $this->attachNew($records, $current, false) 
); 
if (count($changes['attached']) || 
count($changes['updated'])) { 
$this->touchIfTouching(); 
} 
return $changes; 
} 


同步 关联 需要 删除 未 出 现 的 id ， 更 新 已 经 存在 id ， 增 添 新 出 现 的 id e 


$current = $this->newPivotQuery()->pluck( 
$this->relatedPivotKey 
)->all(); 


这 名 用 于 从 中 间 表 中 取出 所 有 关联 的 中 间 表 记录 ， 并 且 取 出 relatedPivotkKey 
值 。 


$detach = array_diff($current, array. keys( 
$records = $this->formatRecordsList($this->parselIds($ids) ) 


2); 


protected function formatRecordsList(array $records) 


( 


return collect($records)-»mapWithKeys(function ($attributes, 
$id) { 
if (! is_array($attributes)) { 
list($id, $attributes) = [$attributes, []]; 


return [$id => $attributes]; 
})->all(); 


这 名 用 于 统计 出 待 删除 的 中 间 表 记录 的 relatedPivotKey 值 。 


if ($detaching && count($detach) > 0) { 
$this->detach($detach) ; 


$changes['detached'] = $this->castKeys($detach) ; 


这 名 进行 删除 操作 。 


$changes = array_merge( 
$changes, $this->attachNew($records, $current, false) 


); 


protected function attachNew(array $records, array $current, $to 
uch = true) 


{ 
$changes = ['attached' => [], 'updated' => []]; 
foreach ($records as $id => $attributes) { 
if (! in_array($id, $current)) { 
$this->attach($id, $attributes, $touch); 
$changes['attached'][] = $this->castKey($id); 
J 
elseif (count($attributes) > 0 && 
$this->updateExistingPivot($id, $attributes, $touch) 
) í 
$changes['updated'][] = $this->castKey($id); 
} 
} 
return $changes; 
} 


对 于 需要 新 增 的 记录 ， 直 接 调 用 方法 attach 即 可 。 对 于 需要 更 新 的 记录 ， 需 要 
调用 updateExistingPivot 


public function updateExistingPivot($id, array $attributes, $tou 
ch = true) 


{ 
if (in_array($this->updatedAt(), $this->pivotColumns)) ( 
$attributes = $this->addTimestampsToAttachment ($attribut 
es, true); 


} 


$updated = $this->newPivotStatementForId($id) ->update($attri 
butes); 


if ($touch) { 
$this->touchIfTouching(); 


return $updated; 


public function newPivotStatementForId(S$id) 


{ 


return $this->newPivotQuery()->where($this->relatedPivotKey, 
$id); 
} 


这 个 函数 主要 调用 update 方法 。 


切换 关联 toggle 


多 对 多 关联 也 提供 了 一 个 toggle 方法 用 于 「 切换 」 给 定 IDs 的 附加 状态 。 如 果 给 定 
ID 已 附加 ， 就 会 被 移 除 。 同 样 的 ， 如 果 给 定 ID 已 移 除 ， 就 会 被 附加 ， 源 码 : 


public function toggle($ids, $touch = true) 
1 
$changes - [ 
'attached' => [], 'detached' => [], 
]; 
$records = $this->formatRecordsList($this->parseIds($ids)); 
$detach = array_values(array_intersect( 
$this->newPivotQuery()->pluck($this->relatedPivotKey)->a 
11(), 


array_keys($records) 


)): 


if (count($detach) » 0) ( 
$this->detach($detach, false); 


$changes['detached'] = $this-»castKeys($detach); 


$attach = array diff key($records, array flip($detach)); 


if (count($attach) > 0) ( 
$this->attach($attach, [], false); 


$changes['attached'] = array_keys($attach); 


if ($touch && (count($changes['attached']) || 
count ($changes['detached']))) { 
$this->touchIfTouching(); 


return $changes; 


toggle “45 intersect 被 关联 的 主键 ， 进 行 detach 所 有 已 经 存在 的 记 
Xo diff 被 关联 的 主键 ， 对 其 进行 attach MAWR ° 


findOrNew 方法 


findorNew 函数 用 于 related 模型 的 主键 搜索 与 新 建 : 


public function findOrNew($id, $columns = ['*']) 


{ 
if (is_null($instance = $this->find($id, $columns))) { 


$instance = $this-»related-»-newInstance(); 


return $instance; 


firstOrNew 方法 


firstorNew SAAT related 模型 的 属性 搜索 与 新 建 : 


public function firstOrNew(array $attributes) 


{ 
if (is_null($instance = $this->where($attributes)->first())) 


$instance = $this->related->newInstance($attributes) ; 


return $instance; 


firstOrCreate 方法 


firstorCreate SAAT related 模型 的 属性 搜索 与 保存 ， attributes 是 
related 模型 的 搜索 属性 或 保存 属性 ， joining 是 中 间 表 属性 : 


public function firstOrCreate(array $attributes, array $joining 
= [], $touch = true) 


{ 
if (is_null($instance = $this->where($attributes) ->first())) 
x 
$instance = $this->create($attributes, $joining, $touch) 
} 
return $instance; 
} 


updateOrCreate 方法 


updateOrCreate 函数 用 于 related 模型 的 更 新 ，attributes X 
related 模型 的 搜索 属性 ， values 是 related 模型 的 更 新 属 
性 ， joining 是 中 间 表 属性 : 
public function updateOrCreate(array $attributes, array $values 
= [], array $joining = [], $touch = true) 
{ 


if (is_null($instance = $this->where($attributes) ->first())) 


return $this->create($values, $joining, $touch); 


$instance->fill($values) ; 
$instance->save(['touch' => false]); 


return $instance; 


Laravel Session——session 的 户 动 与 运 
源码 分 析 


在 网 页 开发 中 ， session 具有 重要 的 作用 ， 它 可 以 在 多 个 请 求 中 存储 用 户 的 信 

息 ， 用 于 识别 用 户 的 身份 信息 。 laravel 为 用 户 提供 了 可 读 性 强 的 API 处 理 各 种 
自 带 的 Session 后 台 驱 动 程序 。 支 持 诸如 比较 热门 的 Memcached、Redis 和 开 箱 

即 用 的 数据 库 等 常见 的 后 台 驱 动 程序 。 本 文 将 会 在 本 篇 文章 中 讲述 最 常见 的 由 
File 与 redis 32% session 源码 。 


session 服务 的 注册 


与 其 他 功能 一 样 ， session 由 自己 的 服务 提供 者 在 container 内 进行 注册 : 


class SessionServiceProvider extends ServiceProvider 


{ 


public TfUNEETON pegdtstert) 


{ 
$this->registerSessionManager(); 
$this->registerSessionDriver(); 
$this->app->singleton(StartSession::class); 
} 
protected function registerSessionManager() 
{ 
$this->app->singleton('session', function ($app) { 
return new SessionManager($app); 
3); 
} 
protected function registerSessionDriver() 
{ 
$this->app->singleton('session.store', function ($app) { 
return $app->make('session')->driver(); 
3); 
} 


可 以 看 到 SessionManager 是 整个 session 服务 的 接口 类 ， 一 切 对 
session 的 操作 都 是 由 这 个 类 实现 。 session.store 是 session 服务 的 存 
储 驱 动 。 


session 服务 的 启动 


session 服务 是 以 中 间 件 的 形式 启动 的 ， 其 中 间 件 是 


Illuminate\Session\Middleware\StartSession 


public function handle($request, Closure $next) 


{ 


$this->sessionHandled = true; 


if ($this->sessionConfigured()) { 
$request ->setLaravelSession( 
$session = $this->startSession($request ) 


); 


$this->collectGarbage($session); 


$response = $next($request); 


if ($this->sessionConfigured()) { 
$this->storeCurrentUrl($request, $session); 


$this->addCookieToResponse($response, $session); 


return $response; 


public function terminate($request, $response) 
{ 
if ($this->sessionHandled && $this->sessionConfigured() && ! 
$this->usingCookieSessions()) { 
$this->manager ->driver()->save(); 


session 服务 的 中 间 件 在 http 会 话 前 与 会 话 后 都 有 处 理 。 
在 会 话 前 ， 

e laravel 试图 从 cookies 中 获取 sessionId ; 

e 利用 sessionId 读 取 服务 器 中 的 session 数据 ; 


e 将 session 对 象 存 入 request 中 ; 
e session 垃圾 回收 


e 存储 当前 的 url 作为 session 的 PreviousUrl 
e 将 当前 的 session GARB cookies 中 
e 保存 当前 的 session 数据 到 存储 器 驱动 


startSession 


startSession 函数 进行 了 session 的 启动 工作 : 


public function — construct(SessionManager $manager ) 


{ 


$this->manager = $manager; 


protected function startSession(Request $request ) 
i 
return tap($this->getSession($request), function ($session) 
use ($request) { 
$session-»setRequestOnHandler($request); 


$session-»start(); 


3): 


public function getSession(Request $request) 
1 
return tap($this->manager->driver(), function ($session) use 
($request) { 
$session->setId($request ->cookies->get($session->getName 
())); 
+); 


E m wi 


session 的 门面 类 sessionManager 


代码 很 简洁 ， session 服务 启动 的 逻辑 被 包含 在 了 sessionManager 
中 ， sessionManager Æ session 服务 的 门面 类 ， 负 责 session 服务 的 驱 


动 加 载 与 数据 操作 。 

首先 我 们 先 看 看 SessionManager : 
namespace IlluminateNSession; 
use Illuminate\Support\Manager ; 


class SessionManager extends Manager 


{ 


SessionManager 继承 Manager X: 
namespace Illuminate\Support; 


abstract class Manager 


{ 
public function driver($driver = null) 
{ 
$driver = $driver ?: $this->getDefaultDriver(); 
if (! isset($this->drivers[$driver])) { 
$this->drivers[$driver] = $this->createDriver ($drive 
r); 
j 
return $this->drivers[$driver]; 
} 
} 


当 我 们 调用 driver 函数 的 时 候 ， 程 序 就 开始 为 “session 服务 加 载 驱动 ， 例 如 
对 数据 库 或 者 redis 驱动， 进行 连接 操作 。 


public function getDefaultDriver() 


{ 


return $this-»app['config']['session.driver']; 


protected function createDriver($driver ) 


{ 


$method = 'create'.Str::studly($driver).'Driver'; 


if (isset($this->customCreators[$driver])) { 
return $this->callCustomCreator($driver ); 

} elseif (method_exists($this, $method)) { 
return $this->$method(); 


throw new InvalidArgumentException("Driver [$driver] not sup 
ported."); 


} 


session 了 驱动 持久 化 类 SessionHandler 


FileSessionHandler 这 个 类 就 是 驱动 ， 它 继承 SessionHandlerInterface 
基 类 ， 任 何 对 session 的 读 取 、 添 加 、 删 除 、 更 新 等 等 操作 最 后 都 要 通过 这 个 驱 
动 类 进行 持久 化 。 


e file 了 驱动 : 


file 驱动 的 核心 是 Filesystem ， 该 类 是 loc 容器 创建 的 : 


protected function createFileDriver() 


( 


return $this-»createNativeDriver(); 


protected function createNativeDriver() 


( 


$lifetime = $this-»app['config']['session.lifetime']; 


return $this->buildSession(new FileSessionHandler ( 
$this->app['files'], $this->app['config']['session.files' 
], $lifetime 
)); 


namespace IlluminateNSession; 


class FileSessionHandler implements SessionHandlerInterface 


{ 


public function _ construct(Filesystem $files, $path, $minut 


es) 
{ 
$this->path = $path; 
$this->files = $files; 
$this->minutes = $minutes; 
} 
} 


BOUS SS | 
e redis 驱动 


redis 驱动 并 不 是 直接 创建 redis ， 而 是 利用 了 laravel 的 缓存 cache 
系统 创建 redis 驱动 ， 然 后 对 redis 驱动 进行 连接 操作 : 


protected function createRedisDriver() 


1 
$handler = $this-»createCacheHandler('redis'); 
$handler ->getCache( ) ->getStore()->setConnection( 
$this-»app['config']['session.connection'] 
); 
return $this->buildSession($handler ); 
} 


protected function createCacheHandler ($driver) 
{ 

$store = $this->app['config']->get('session.store') ?: $driv 
er; 


return new CacheBasedSessionHandler ( 
clone $this->app['cache']->store($store), 
$this->app['config']['session.lifetime' ] 


); 


class CacheBasedSessionHandler implements SessionHandlerInterface 


{ 
public function __construct(CacheContract $cache, $minutes) 
{ 
$this->cache = $cache; 
$this->minutes = $minutes; 
} 
} 


加 | 
session 数据 操作 类 


buildSession 有 函数 将 会 返回 Store 类 ， 这 个 Store 类 实际 上 session 
服务 数据 操作 的 实质 类 ， 任 何 对 session 数据 的 操作 实际 上 调用 的 都 是 Store 
类 : 


protected function buildSession(S$handler) 
{ 
if ($this->app['config']['session.encrypt']) { 
return $this->buildEncryptedSession($handler); 
} else { 
return new Store($this->app['config']['session.cookie'], 
$handler); 


j 


protected function buildEncryptedSession($handler) 
{ 
return new EncryptedStore( 
$this-»app['config']['session.cookie'], $handler, $this- 
>app['encrypter' ] 
); 


} 
public function __call($method, $parameters) 
{ 
return $this->driver()->$method(...$parameters); 
} 


如 果 需 要 对 session 进行 加 密 ， 那 么 就 会 创建 一 个 EncryptedStore K° % 
类 继承 Store 类 。 


setid 


session 驱动 建立 之 后 ， 就 要 进行 sessionId 的 设置 ， 如果 cookie 中 存在 
sessionId ， 我 们 就 会 从 中 获取 ， 否 则 我 们 就 需要 重新 生成 新 的 sessionid 


public function setId($id) 


1 

$this->id = $this->isValidId($id) ? $id : $this->generateSes 
sionId(); 
J 


public function isValidId($id) 
{ 

return is_string($id) && ctype alnum($id) && strlen($id) === 
40; 


j 
protected function generateSessionId() 
{ 
return Str::random(40); 
j 


E E 





session--start 


一 切 准 备 就 绪 后 ， 我 们 就 要 局 动 session ， 如 果 当 前 请 求 存在 未 过 期 
session ， 那 么 就 要 利用 session 驱动 将 数据 读 取 出 来 : 


public function Start) 


{ 
$this->loadSession(); 
if (! $this->has('_token')) { 
$this->regenerateToken(); 
} 
return $this->started = true; 
} 


protected function loadSession() 


( 


$this->attributes = array merge($this-»attributes, $this->re 
adFromHandler()); 
} 


readFromHandler 有 函数 就 是 读 取 session 的 过 程 : 


protected function readFromHandler() 


{ 
if ($data = $this->handler->read($this->getId())) ( 
$data = @unserialize($this->prepareForUnserialize( $data) 
); 
if ($data !-- false && ! is null($data) && is array($dat 
a)) { 
return $data; 
} 
} 
return []; 
} 


e 未 加 密 session 数据 的 加 载 


对 于 未 加 密 的 session 来 说 ， prepareForUnserialize 直接 返回 了 数据 : 


protected function prepareForUnserialize($data) 


{ 


return $data; 


e JŽ session 数据 


protected function prepareForUnserialize( $data) 


t 
try { 
return $this-»encrypter-»decrypt($data); 
) catch (DecryptException $e) ( 
return serialize([]); 
J 
} 
e file 驱动 


public function read($sessionId) 


{ 
if ($this->files->exists($path = $this->path.'/'.$sessionId) 


)t 
if (filemtime($path) >= Carbon: :now()->subMinutes($this- 
>minutes)->getTimestamp()) { 
return $this->files->get($path, true); 


retur. au: 


e redis 驱动 


public function read($sessionId) 


í 


return $this->cache->get($sessionId, ''); 


session 垃圾 回收 


session 的 垃圾 回收 用 于 随机 性 地 删除 日 session 数据 。 由 于 某 些 驱动 ， 例 
如 FileSessionHandler ， 程 序 不 会 定期 删除 那些 已 经 过 时 的 session x 
件 ， 那 么 session 文件 一 定 会 越 来 越 多 ， 所 以 我 们 就 需要 一 种 垃圾 回收 机 制 : 


protected function collectGarbage(Session $session) 


{ 


$config = $this->manager ->getSessionConfig(); 


if ($this->configHitsLottery($config)) { 
$session->getHandler()->gc($this->getSessionLifetimeInSe 
conds()); 
} 


protected function configHitsLottery(array $config) 


{ 
return random int(1, $config['lottery'][1]) <= $config['lott 


ery'][9]; 
j 


configHitsLottery Zt sb | BE 4 Aye SRM PLB ILA IEF © 3X fb 
随机 性 概率 由 lottery 来 设置 。 


FileSessionHandler 的 垃圾 回收 : 


public function gc($lifetime) 


{ 
$files = Finder: :create() 
->in($this->path) 
->files() 
->ignoreDotFiles(true) 
->date('<= now - '.$lifetime.' seconds'); 
foreach ($files as $file) { 
$this->files->delete($file->getRealPath()); 
} 
} 
存储 前 一 页 


很 多 时 候 我 们 都 需要 从 session 中 获取 前 一 页 的 地 址 ， 例 如 用 户 授权 失败 就 会 返 
回 上 一 页 等 等 情景 。 


protected function storeCurrentUrl(Request $request, $session) 
{ 
if ($request->method() === 'GET' && $request->route() && ! $ 
request->ajax()) ( 
$session-»setPreviousUrl(S$request-»fullUrl()); 


} 
} 
public function setPreviousUrl($url) 
{ 
$this->put('_previous.url', $url); 
} 


中 间 件 的 结 


当 请 求 结 束 时 ， 会 调用 中 间 件 的 terminate 函数 ， 这 里 程序 会 将 新 的 
session 数据 持久 化 到 各 个 驱动 器 中 : 


public function terminate($request, $response) 


{ 
if ($this->sessionHandled && $this->sessionConfigured() && ! 
$this->usingCookieSessions()) { 
$this->manager ->driver()->save(); 


session 的 保存 : 


public function save() 


{ 
$this->ageFlashData(); 


$this->handler ->write($this->getId(), $this->prepareForStora 
ge( 
serialize($this->attributes) 


2); 


$this->started = false; 


session 的 保存 会 删除 需要 flash 的 闪存 数据 ， 也 就 是 只 想 用 于 下 一 次 请 求 的 
数据 : 


public function ageFlashData() 


1 
$this->forget($this->get('_flash.old', [])); 
$this->put('_flash.old', $this->get('_flash.new', [])); 
$this->put('_flash.new', []); 

} 


对 于 不 加 密 的 数据 ， 保 存 前 的 prepareForsStorage 不 会 对 数据 进行 任何 操作 : 


protected function prepareForStorage($data) 


{ 


return $data; 


对 于 加 密 的 数据 ， 则 需要 事先 加 密 : 
protected function prepareForStorage($data) 


( 


return $this-»encrypter-»encrypt($data); 


session 数据 操作 


get 函数 
当 我 们 想 要 获取 session 中 的 数据 时 ， 我 们 经 常 使 用 get 方法 


public function show(Request $request, $id) 
{ 


$value = $request->session()->get('key'); 


YH 


get 方法 首先 会 调用 sessionManager 的 魔术 方法 : 


public function _ call($method, $parameters) 


{ 


return $this->driver()->$method(...$parameters); 


driver 函数 会 返回 Store 对 象 ， 调 用 get 方法 


public function get($key, $default = null) 


return Arr: :get($this->attributes, $key, $default); 


我 们 从 上 一 节 知 道 ， 在 startSsession 中 间 件 局 动 后 ， session 数据 已 经 加 载 
到 了 store 对 象 中 ， 因 此 获取 数据 很 简单 : 


public function get($key, $default = null) 


{ 
return Arr: :get($this->attributes, $key, $default); 
} 
all 了 水 数 


all 函数 可 以 取出 所 有 的 session 数据 


public function all() 


{ 
return $this->attributes; 
} 
has x 
要 确定 Session 中 是 否 存 在 某 个 值 ， 可 以 使 用 has 方法。 如果 该 值 存在 且 不 为 


null ， 那 么 has 方法 会 返回 true 


public function has($key) 
X 
return ! collect(is array($key) ? $key : func get args())-»c 
ontains(function ($key) { 
return is_null($this->get($key)); 
3): 


exists X 


要 确定 Session 中 是 否 存 在 某 个 值 ， 即 使 其 值 为 null ， 也 可 以 使 用 exists 
方法 。 如 果 值 存在 ， 则 exists 方法 返回 true 


public function exists($key) 


{ 
return ! collect(is_array($key) ? $key : func get args())-»c 
ontains(function ($key) { 
return ! Arr::exists($this->attributes, $key); 


3); 


put 方法 
要 存储 数据 到 Session ， 可 以 使 用 put AK 


public function put($key, $value = null) 


{ 
if (! is array($key)) { 
$key = [$key => $value]; 
} 
foreach ($key as $arrayKey => $arrayValue) { 
Arr::set($this->attributes, $arrayKey, $arrayValue); 
} 
} 


push 方法 


push 方法 可 以 将 一 个 新 的 值 添加 到 Session 数组 内 。 


public function push($key, $value) 


{ 
$array = $this->get($key, []); 
$array[] = $value; 
$this->put($key, $array); 

} 


remember 方法 


remember 方法 用 于 有 即 取 ， 无 即 存 的 情况 : 


public function remember($key, Closure $callback) 


{ 
if (! is_null($value = $this->get($key))) { 
return $value; 


return tap($callback(), function ($value) use ($key) { 
$this->put($key, $value); 
3); 


increment 方法 


increment 方法 用 于 增加 某 session 数据 的 值 : 


public function increment($key, $amount = 1) 
{ 
$this->put($key, $value = $this->get($key, ©) + $amount); 


return $value; 


decrement 方法 


public function decrement($key, $amount = 1) 
{ 


return $this->increment($key, $amount * -1); 


pull 方法 
pull 方法 可 以 只 用 一 条 语句 就 从 Session 检索 并 且 删 除 一 个 项 目 : 
public function pull($key, $default = null) 


{ 
return Arr: :pull($this->attributes, $key, $default); 


flash 闪存 数据 

有 时 候 你 仅 想 在 下 一 个 请 求 之 前 在 Session 中 存 入 数据 ， 你 可 以 使 用 flash 
方法 。 使 用 这 个 方法 保存 在 ”session 中 的 数据 ， 只 会 保留 到 下 个 HTTP 请 求 到 
来 之 前 ， 然 后 就 会 被 删除 。 闪 存 数据 主要 用 于 短期 的 状态 消息 


public function flash($key, $value) 


{ 
$this->put($key, $value); 
$this->push('_flash.new', $key); 
$this->removeFromOldFlashData( [$key] ); 
} 


protected function removeFromOldFlashData(array $keys) 
{ 
$this->put('_flash.old', array_diff($this->get('_flash.old', 
[1), $keys)); 
} 


闪存 数据 的 实现 很 简单 ， session 中 会 维护 两 个 数 
组 :  flash.new ^  flash.old ,每 次 session 结束 前 ， 都 会 删除 
_flash.old 中 的 存储 的 key 对 应 存储 在 session 的 value ° 


now 方法 
now 方法 用 于 存储 只 有 本 次 请 求 采 用 的 数据 


public function now($key, $value) 
{ 
$this->put($key, $value); 


$this->push('_flash.old', $key); 


reflash 方法 


如 果 需 要 保留 闪存 数据 给 更 多 请 求 ， 可 以 使 用 reflash 方法 ， 这 将 会 将 所 有 的 闪存 
数据 保留 给 其 他 请 求 。 


public function reflash() 


{ 
$this->mergeNewFlashes($this->get(' flash.old', [])); 


$this-»put(' flash.old', []); 


这 样 ， flash.old 中 的 数据 就 会 被 合并 到  flash.new 中 。 


keep 方法 


只 想 保留 特定 的 闪存 数据 给 更 多 请 求 ， 则 可 以 使 用 keep 方法 : 


public function keep($keys = null) 
1 
$this->mergeNewFlashes($keys = is array($keys) ? $keys : fun 


c get args()); 


$this-»removeFromOldFlashData($keys); 


forget 方法 
forget 方法 可 以 从 Session 内 删除 一 条 数据 。 


public function forget($keys) 
{ 
Arr: :forget($this->attributes, $keys); 


flush 方法 


如 果 你 想 删 除 Session 内 所 有 数据 ， 可 以 使 用 flush 方法 : 


public function flush() 


{ 
$this->attributes = []; 


重新 生成 Session ID 


重新 生成 Session ID ， 通 常 是 为 了 防止 恶意 用 户 利 用 session fixation 对 
应 用 进行 攻击 。 如 果 使 用 了 内 置 函 数 LoginController > Laravel 会 自动 重新 生 
成 身份 验证 中 Session ID 。 否 则 ， 你 需要 手动 使 用 regenerate 方法 重新 生 
成 Session ID 。 


public function regenerate($destroy = false) 


{ 


return $this->migrate($destroy); 


public function migrate($destroy = false) 


{ 


if ($destroy) { 


$this->handler ->destroy($this->getId()); 


$this->setExists(false); 


$this->setId($this->generateSessionId()); 


ise ttam e 
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码 分 析 


Laravel 的 事件 系统 是 一 个 简单 的 观察 者 模式 ， 主 要 目的 是 用 于 代码 的 解 磋 ， 可 
以 防止 不 同 功能 的 代码 耦合 在 一 起 。 laravel 中 事件 系统 由 两 部 分 构成 ， 一 个 是 
事件 的 名 称 ， 事 件 的 名 称 可 以 是 个 字符 串 ， 例 如 event.email ， 也 可 以 是 一 个 事 
件 类 ， 例 如 App\Events\OrderShipped ; 另 一 个 是 事件 的 listener ， 可 以 是 
一 个 闭 包 ， 还 可 以 是 监听 类 ， 例 如 
App\Listeners\SendShipmentNotification ° 


事件 服务 的 注册 


事件 服务 的 注册 分 为 两 部 分 ， 一 个 是 Application 启动 时 所 调用 的 


registerBaseServiceProviders 函数 : 


protected function registerBaseServiceProviders() 
{ 
$this->register(new EventServiceProvider($this) ); 


$this->register(new LogServiceProvider($this) ); 


$this->register(new RoutingServiceProvider($this) ); 


其 中 的 EventServiceProvider 是 


/Illuminate/Events/EventServiceProvider 


public funcEton)register() 


{ 
$this->app->singleton('events', function ($app) { 
return (new Dispatcher($app))->setQueueResolver(function 


() use (Sapp) { 
return $app-»make(QueueFactoryContract::class); 


3): 
3): 


这 部 分 为 Ioc 容器 注册 了 events 实例 ， Dispatcher HÆ events Hib 
的 实现 类 。 QueueResolver 是 队列 化 事件 的 实现 。 


另 一 个 注册 是 普通 注册 类 /app/Providers/EventServiceProvider 


class EventServiceProvider extends ServiceProvider 


{ 
protected $listen = [ 


'AppNEventsNSomeEvent' => [ 
'AppNListenersNEventListener', 
] 
l; 


public function boot() 


{ 
parent: :boot(); 
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这 个 注册 类 的 主要 作用 是 事件 系统 的 启动 ， 这 个 类 继承 自 


/Illuminate/Foundation/Support/Providers/EventServiceProvider 


class EventServiceProvider extends ServiceProvider 
{ 
protected $listen = []; 


protected $subscribe = []; 


public function boot() 


t 
foreach ($this->listens() as $event => $listeners) { 
foreach ($listeners as $listener) { 
Event: :listen($event, $listener); 
} 
} 
foreach ($this->subscribe as $subscriber) { 
Event: :subscribe($subscriber ); 
} 
} 


可 以 看 到 ， 事 件 系 统 的 启动 主要 是 进行 事件 系统 的 监听 与 订阅 。 


事件 系统 的 监听 listen 


所 谓 的 事件 监听 ， 就 是 将 事件 名 与 团 包 函数 ， 或 者 事件 类 与 监听 类 之 间 建 立 关 联 。 


public function listen($events, $listener) 


{ 
foreach ((array) $events as $event) { 
if (Str::contains($event, '*')) { 
$this->setupwildcardListen($event, $listener); 
} else { 
$this->listeners[$event][] = $this->makeListener($li 
stener); 
} 
} 
} 


protected function setupWildcardListen($event, $listener) 


{ 
$this->wildcards[$event][] = $this->makeListener($listener, 
true); 


} 


对 于 有 通配符 的 事件 名 ， 会 统一 放 入 wildcards 数组 中 ， makeListener 是 创 
建 事 件 的 关键 : 


public function makeListener($listener, $wildcard = false) 


X 
if (is string($listener)) { 
return $this->createClassListener($listener, $wildcard); 


} 
return function ($event, $payload) use ($listener, $wildcard) 
{ 
if ($wildcard) { 
return $listener($event, $payload); 
) else { 
return $listener(...array_values($payload) ); 
} 
}; 
} 





创建 监听 者 的 时 候 ， 会 判断 监听 对 象 是 监听 类 还 是 闭 包 函 数 。 
对 于 闭 包 监听 来 说 ， makeListener 会 再 包 上 一 层 闭 包 郊 数 ， 根 据 是 否 含 有 通 配 


符 来 确定 具体 的 参数 。 


对 于 监听 类 来 说 ， 会 继续 createClassListener : 


public function createClassListener($listener, $wildcard = false) 


return function ($event, $payload) use ($listener, $wildcard) 


if ($wildcard) { 
return call user func($this-»createClassCallable($1li 
stener), $event, $payload); 
} else { 
return call user func array( 
$this->createClassCallable($listener), $payload 





); 


} 
J; 
} 
protected function createClassCallable($listener) 
{ 
list($class, $method) = $this->parseClassCallable($listener ) 
if ($this->handlerShouldBeQueued($class)) { 
return $this->createQueuedHandlerCallable($class, $metho 
d); 
) else { 
return [$this->container->make($class), $method]; 
} 
} 


SEE ae al 
对 于 监听 类 来 说 ， 程 序 首先 会 判断 监听 类 对 应 的 函数 : 


protected function parseClassCallable($listener ) 
{ 


return Str::parseCallback($listener, 'handle'); 
如 果 未 指定 监听 类 的 对 应 函数 ， 那 么 会 默认 handle Až o 
如 果 当 前 监听 类 是 队列 的 话 ， 会 将 任务 推送 给 队列 。 


触发 事件 


事件 的 触发 可 以 利用 事件 名 ， 或 者 事件 类 的 实例 : 


public function dispatch($event, $payload = [], $halt = false) 


{ 
list($event, $payload) = $this->parseEventAndPayload( 


$event, $payload 
); 


if ($this->shouldBroadcast($payload)) { 
$this->broadcastEvent ($payload[0]); 


$responses = []; 


foreach ($this->getListeners($event) as $listener) { 
$response = $listener($event, $payload); 


if (! is_null($response) && $halt) { 
return $response; 


} 

if ($response === false) { 
break; 

} 


$responses[] = $response; 


return $halt ? null : $responses; 


parseEventAndPayload 函数 利用 传 入 参数 是 事件 名 还 是 事件 类 实例 来 确定 监听 
类 函数 的 参数 : 


protected function parseEventAndPayload($event, $payload) 


1 
if (is object($event)) ( 
list($payload, $event) = [[$event], get class($event)]; 


return [$event, array wrap($payload)]; 


如 果 是 事件 类 的 实例 ， 那 么 监听 函数 的 参数 就 是 事件 类 自身 i REFRA > A 
么 监听 函数 的 参数 就 是 触发 事件 时 传 入 的 参数 。 


获得 事件 与 参数 后 ， 就 要 获取 监听 类 : 


public function getListeners($eventName ) 
{ 

$listeners = isset($this->listeners[$eventName]) ? $this-»li 
steners[$eventName] : []; 


$listeners = array_merge( 
$listeners, $this->getwildcardListeners($eventName ) 


); 


return class_exists($eventName, false) 
? $this->addInterfaceListeners($eventName, $list 
eners) 
: $listeners; 


寻找 监听 类 的 时 候 ， 也 要 从 通配符 监听 器 中 寻找 : 


protected function getWildcardListeners($eventName ) 


{ 
$wildcards = []; 


foreach ($this->wildcards as $key => $listeners) { 
if (Str::is($key, $eventName)) { 
$wildcards = array_merge($wildcards, $listeners); 


return $wildcards; 


如 果 监 听 类 继承 自 其 他 类 ， 那 么 父 类 也 会 一 并 当做 监听 类 返回 
获得 了 监听 类 之 后 ， 就 要 调用 监听 类 相应 的 函数 。 


触发 事件 时 有 一 个 参数 halt ， 这 个 参数 如 果 是 true 的 时 候 ， 只 要 有 一 个 监听 
类 返回 了 结果 ， 那 么 就 会 立刻 返回 。 例 如 : 


public function testHaltingEventExecution() 


{ 
unset ($_SERVER['__event.test']); 


$d = new Dispatcher; 
$d->listen('foo', function ($foo) { 
$this->assertTrue(true); 


return 'here'; 


3); 
$d->listen('foo', function ($foo) { 
throw new Exception('should not be called'); 


3); 
$d->until('foo', ['bar']); 


个 监听 类 在 运行 的 时 候 ， 只 要 有 一 个 返回 了 false > MAHAPH SH o 


push 函数 


push 函数 可 以 将 触发 事件 的 参数 事先 设置 好 ， 这 样 触发 的 时 候 只 要 写 入 事件 名 
即 可 ， 例 如 : 


public function testQueuedEventsAreFired( ) 


{ 
unset($ SERVER[' _event.test']); 
$d = new Dispatcher; 
$d->push('update', ['name' => 'taylor']); 
$d->listen('update', function ($name) { 
$ SERVER[' event.test'] = $name; 
3); 
$this-»-assertFalse(isset($ SERVER[' event.test'])); 
$d->flush('update'); 
$this->assertEquals('taylor', $ SERVER[' event.test']); 
} 
原理 也 很 简单 : 


public function push($event, $payload = []) 


1 

$this->listen($event.' pushed', function () use ($event, $pa 
yload) { 

$this->dispatch($event, $payload); 

3); 
} 
public function flush($event ) 
{ 

$this->dispatch($event.' pushed'); 
} 


数据 库 Eloquent 的 事件 


数据 库 模 型 的 事件 的 注册 除了 以 上 的 方法 还 有 另外 两 种 ， 具 体 详情 可 以 看 : Laravel 
模型 事件 实现 原理 ; 
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事件 注册 
e PASERI 


class EventServiceProvider extends ServiceProvider 


{ 


public function boot() 


parent: :boot(); 
User::saved(function(User$user) { 
3); 
User: :saved('UserSavedListener@saved' ); 
j 


e 观察 者 


class UserObserver 


t 
public function created(User $user) 
{ 
UF 
} 
public function saved(User $user) 
{ 
777. 
} 
} 


然后 在 某 个 服务 提供 者 的 boot 方 法 中 注册 观察 者 : 
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class AppServiceProvider extends ServiceProvider 


{ 
public function boot() 


{ 
User: :observe(UserObserver::class); 
} 
public function register( ) 
{ 
Ld 
} 


这 两 种 方法 都 是 向 事件 系统 注册 事件 名 eloquent. {$event}: 
{static::class} : 


public static function saved($callback) 


( 


static::registerModelEvent('saved', $callback); 


protected static function registerModelEvent($event, $callback) 
{ 
if (isset(static::$dispatcher)) { 
$name = static::class; 


static: :$dispatcher->listen("eloquent.{$event}: {$name}" 
, $callback); 


public static function observe($class) 


{ 
$instance = new static; 
$className = is_string($class) ? $class : get_class($class); 
foreach ($instance->getObservableEvents() as $event) { 
if (method_exists($class, $event)) { 
static::registerModelEvent($event, $className.'@'.$e 
vent); 
} 
} 
} 
public function getObservableEvents() 
{ 
return array_merge( 
[ 
'creating', 'created', 'updating', ‘updated’, 
'deleting', 'deleted', 'saving', 'saved', 
'restoring', 'restored', 
], 
$this->observables 
); 
} 


事件 触发 


模型 事件 的 触发 需要 调用 fireModelEvent 3k: 


protected function fireModelEvent($event, $halt = true) 


1 
if (! isset(static::$dispatcher)) { 
return true; 


} 
$method = $halt ? 'until' : 'fire'; 
$result = $this->fireCustomModelEvent($event, $method); 


return ! is null($result) ? $result : static: :$dispatcher ->{ 
$method}( 
"eloquent.{$event}: ".static::class, $this 


); 


fireCustomModelEvent 是 我 们 本 文中 着 重 讲 的 事件 类 与 监听 类 的 触发 : 


protected function fireCustomModelEvent($event, $method) 


{ 
if (! isset($this->events[$event])) { 
return; 


$result = static::$dispatcher->$method(new $this->events[$ev 
ent]($this)); 


if (! is_null($result)) { 
return $result; 


如 果 没 有 对 应 的 事件 后 ， 会 继续 利用 事件 名 进行 触发 。 


until 是 我 们 上 一 节 讲 的 如 果 任 意 事件 返回 正确 结果 ， 就 会 直接 返回 ， 不 会 继续 
进行 下 一 个 事件 。 
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Laravel Queue 一 一 消息 队列 任务 与 分 发 源码 
剖析 


在 实际 的 项 目 开发 中 ， 我 们 经 常会 遇 到 需要 轻 量 级 队列 的 情形 ， 例 如 发 短信 、 发 邮 
件 等 ， 这 些 任务 不 足以 使 用 kafka ^ RabbitMQ 等 重量 级 的 消息 队列 ， 但 是 又 
的 确 需要 异步 、 重 试 、 并 发 控制 等 功能 。 通 常 来 说 ， 我 们 经 常会 使 用 

Redis ^ Beanstalk ^ Amazon SQS 来 实现 相关 功能 ， laravel 为 此 对 不 同 
的 后 台 队 列 服务 提供 统一 的 API ， 本 文 将 会 介绍 应 用 最 为 广泛 的 redis 队列 。 


本 文 参 考 文档 资料 : 
使 用 Laravel Queue 不 得 不 明白 的 知识 


Laravel 的 消息 队列 训 析 


背景 知识 


在 讲解 laravel 的 队列 服务 之 前 ， 我 们 要 先 说 说 基于 redis 的 队列 服务 。 首 
先 ，redis 设 计 用 来 做 缓存 的 ， 但 是 由 于 它 自身 的 某 种 特性 使 得 它 可 以 用 来 做 消息 队 
列 , 


redis 队列 的 数据 结构 
e List 链表 


redis 做 消息 队列 的 特性 例如 FIFO (先入 先 出 ) 很 容易 实现 ， 只 需要 一 个 
list 对 象 从 头 取 数据 ， 从 尾部 塞 数 据 即 可 。 


相关 的 命令 : (1) 左 侧 入 右 侧 出 : lpush/rpop ; (2) 右 侧 入 左 侧 出 : 
rpush/Ipop ° 


这 个 简单 的 消息 队列 很 容易 实现 。 


e Zset 有 序 集 合 


有 些 任 务 场 景 ， 并 不 需 刻 执 行 ， 需要 延迟 执行 ; qe eed 
XE 4E CK AY WY SH uA o x Rx Mois list 是 无 法 完成 的 。 ne 
候 ， 就 需要 redis 的 有 序 P^ o 


Redis 有 序 集合 和 Redis 集合 类 似 ， 是 不 包含 相同 字符 串 的 合集 。 它 们 的 差别 
是 ， 每 个 有 序 集合 的 成 员 都 关联 着 一 个 评分 score ， 这 个 评分 用 于 把 有 序 集合 中 
的 成 员 按 最 低 分 到 最 高 分 排列 。 


最 1 
单 看 有 序 集合 pater ue 集合 的 评分 score 设置 为 延 
ches 之 后 轮 询 这 个 有 序 集合 ， 将 到 期 的 任务 拿 出 来 进行 处 理 ， 这 样 
就 实现 了 延迟 a 


对 于 重要 的 需要 重 试 的 任务 ， 在 任务 执行 之 前 ， 会 
任务 最 长 的 执行 时 间 。 Se es 
务 没 有 在 规定 时 间 内 完成 ， 那 么 该 有 序 集合 的 任务 ; 


将 
务 
将 


该 任务 放 入 有 序 集 合 中 ， 设 置 
会 在 有 序 集 合 中 删除 。 如 果 任 
将 会 被 重新 放 入 队列 中 。 

相关 命令 

(1) ZADD 添加 一 个 或 多 个 成 员 到 有 序 集合 ， 或 者 如 果 它 已 经 存在 更 新 其 分 数 。 
(2) ZRANGEBYSCORE 按 分 数 返 回 一 个 成 员 范 围 的 有 序 集合 。 


(3) ZREMRANGEBYRANK 在 给 定 的 索引 之 内 删除 所 有 成 员 的 有 序 集合 。 


laravel 队列 服务 的 任务 调度 


队列 服务 的 任务 调度 过 程 如 下 : 





默认 队列 List 运行 下 一 任务 E 
pop > 
运行 
> bie 取出 下 -任务 
zremrangebyran k za 
待 处 理 任务 Zset 
Eg madii Ee 
zadd 
4 
N 运行 失败 


laravel 的 队列 服务 由 两 个 进程 控制 ， 一 个 是 生产 者 ， 一 个 是 消费 者 。 这 两 个 进 
程 操纵 了 redis 三 个 队列 ， 其 中 一 个 List ， 负 责 即 时 任务 ， 两 个 Zset ， 负 
责 延 时 任务 与 待 处 理 任务 。 
生产 者 负责 向 redis 推送 任务 ， 如 果 是 即时 任务 ， 默 认 就 会 向 

queue:default 推送 ; 如 果 是 延 时 任务 ， 就 会 向 queue:default:delayed 推 


消费 者 轮 询 两 个 队列 ， 不 断 的 从 队列 中 取出 任务 ， 先 把 任务 放 入 
queue:default:reserved 中 ， 再 执行 相关 任务 。 如 果 任 务 执行 成 功 ， 就 会 删除 
queue:default:reserved 中 的 任务 ， 否 则 会 被 重新 放 入 
queue:default:delayed 队列 中 。 


laravel 队列 服务 的 总 体 流程 


任务 分 发 流程 : 


‘job’ => 'Illuminate\Queue\CallQueuedHandler@call', 


'maxTries' => isset(Sjob-»tries) ? $job->tries : null, 
'timeout' => isset($job->timeout) ? $job->timeout : null, 
‘data’ => 
'commandName' => get_class($job), 
‘command! => serialize(clone $job), 







dispatchToQueue 


dispatch connection 


zadd 


任务 处 理 器 运作 : 












job' => 'Illuminate\Queue\CallQueuedHandler@call’, 
'maxTries' => isset($job->tries) ? $job—>tries : null, 
"timeout => isset($job->timeout) ? $job-»timeout : null, 


'commandName' => get. class($job), 
'command' => serialize(clone $job), 





getNextJob 


delayed 
pop Ipop fire 
WorkCommand o RedisJob Mero 
reserved 


H call 





laravel 队列 服务 的 注册 与 启动 
laravel 队列 服务 需要 注册 的 服务 比较 多 : 


class QueueServiceProvider extends ServiceProvider 


{ 


public function register() 


{ 
$this->registerManager(); 
$this->registerConnection(); 
$this->registerworker(); 
$this->registerListener(); 
$this->registerFailedJobServices(); 
} 


registerManager 注册 门面 


registerManager 负责 注册 队列 服务 的 门面 类 : 


protected function registerManager ( ) 


1 
$this->app->singleton('queue', function ($app) { 
return tap(new QueueManager($app), function (Smanager) { 
$this->registerConnectors($manager ); 
3); 
3); 
} 


public function registerConnectors($manager ) 


1 
foreach (['Null', 'Sync', 'Database', 'Redis', 'Beanstalkd', 
'Sqs'] as $connector) ( 
$this->{"register {$connector }Connector"}($manager ); 


protected function registerRedisConnector ($manager ) 


{ 
$manager ->addConnector('redis', function () { 
return new RedisConnector($this->app['redis']); 


+); 


QueueManager 是 队列 服务 的 总 门面 ， 提 供 一 切 与 队列 相关 的 操作 接 
口 。 QueueManager 中 有 一 个 成 员 变量 $connectors ， 该 成 员 变量 中 存储 着 所 
有 laravel 支持 的 底层 队列 服务 : 'Database', 'Redis', 'Beanstalkd', 'Sqs' ° 


class QueueManager implements FactoryContract, MonitorContract 


| 


public function addConnector($driver, Closure $resolver ) 


{ 


$this->connectors[$driver] = $resolver; 


成 员 变量 F$connectors 会 被 存储 各 种 驱动 的 connector ， 例 如 
RedisConnector ^ SqsConnector ^ DatabaseConnector ^ BeanstalkdCo 


nnector 9? 
registerConnection 底层 队列 连接 服务 
接 下 来 ， 就 要 连接 实现 队列 的 底层 服务 了 ， 例 如 redis 


protected function registerConnection( ) 


{ 
$this->app->singleton('queue.connection', function ($app) { 
return $app['queue']-»connection(); 
3); 
} 
public function connection($name = null) 
{ 
$name = $name ?: $this->getDefaultDriver(); 
if (! isset($this->connections[$name])) { 
$this->connections[$name] = $this->resolve($name) ; 
$this->connections[$name] ->setContainer($this->app); 
j 
return $this->connections[$name]; 
} 
public function getDefaultDriver() 
{ 
return $this->app['config']['queue.default']; 
} 


connection HRAAASKR 连接 名 ， 没 有 连接 名 就 会 从 config PRE 
默认 的 连接 。 


protected function resolve($name) 


{ 
$config = $this->getConfig($name) ; 
return $this->getConnector($config['driver']) 
->connect ($config) 
->setConnectionName( $name) ; 
} 


resolve 函数 利用 相应 的 底层 驱动 connector 进行 连接 操作 ， 也 就 是 
connect 函数， 该 函数 会 返回 RedisQueue 


class RedisConnector implements ConnectorInterface 


{ 


public function connect(array $config) 


{ 
return new RedisQueue( 
$this->redis, $config['queue'], 
Arr::get($config, 'connection', $this->connection), 
Arr::get($config, 'retry_after', 60) 
); 
} 


registerWorker 消费 者 服务 注册 
消费 者 的 注册 服务 会 返回 Illuminate\Queue\Worker 类 : 


protected function registerWorker() 
{ 
$this->app->singleton('queue.worker', function () { 
return new Worker ( 
$this->app['queue'], $this->app['events'], $this->ap 
p[ExceptionHandler::class] 
); 
3); 


laravel Bus 服务 注册 与 启动 


定义 好 自己 想 要 的 队列 类 之 后 ， 还 需要 将 队列 任务 推送 给 底层 驱动 后 台 ， 例 如 
redis ， 一 般 会 使 用 dispatch A: 


Job: :dispatch(); 


或 者 


$job = (new ProcessPodcast($pocast)); 


dispatch($job); 


dispatch 函数 就 是 Bus 服务 ， 专 门 用 于 分 发 队列 任务 。 


class BusServiceProvider extends ServiceProvider 


{ 


public function register() 


{ 


$this->app->singleton(Dispatcher::class, function ($app) 


return new Dispatcher($app, function ($connection = 
null) use ($app) { 


return $app[QueueFactoryContract: :class]->connec 
tion($connection); 


3); 
3): 


$this-»app-»alias( 
Dispatcher::class, DispatcherContract::class 


); 


$this-»app-»alias( 
Dispatcher::class, QueueingDispatcherContract::class 


); 








创建 任务 
queue 设置 


'redis' => [ 
'driver' => 'redis', 
'connection' => 'default', 
'queue' => 'default', 
'retry after' => 90, 
], 


日 


一 般 来 说 ， 默 认 的 redis 配置 如 上 ， connection 是 database 中 redis 
的 连接 名 称 ; TE 是 redis 中 的 队列 名 称 ， 值 得 注意 的 是 ， 如 果 使 用 的 是 
redis 集群 的 话 ， 这 个 需要 使 用 key hash tag >? UH {default} ; 当 任务 
运行 超过 retry_after 这 个 时 间 后 ， 该 任务 会 被 重新 放 入 队列 当中 。 


务 类 的 创建 
e 任务 类 的 结构 很 简单 ， 一 般 来 说 只 会 包含 一 个 让 队列 用 来 调用 此 任务 的 
handle 方法 。 


e 如 果 想 要 使 得 任务 被 推送 到 队列 中 ， 而 不 是 同步 执行 ， 那 么 需要 实现 
Illuminate\Contracts\Queue\ShouldQueue 接口 。 


e 如 果 想 要 让 任务 推送 到 特定 的 连接 中 ， 例 如 redis 或 者 sqs ， 那 么 需要 设 


置 conneciton 变量 。 
e 如 果 想 要 让 任务 推送 到 特定 的 队列 中 去 ， 可 以 设置 queue 变量 。 
e 如 果 想 要 让 任务 延迟 推送 ， 那 么 需要 设置 delay 变量 。 
e 如 果 想 要 设置 任务 至 多 重 试 的 次 数 ， 可 以 使 用 tries FE; 
e 如 果 想 要 设置 任务 可 以 运行 的 最 大 秒 数 ， 那 么 可 以 使 用 timeout 参数 。 


e 如 果 想 要 手动 访问 队列 ， 可 以 使 用 trait 


IlluminateNQueueNInteractsWithQueue ° 


o 如 果 队 列 监听 器 任务 执行 次 数 超过 在 工作 队列 中 定义 的 最 大 尝试 次 数 ， 监 听 器 
的 failed 方法 将 会 被 自动 调用 。 failed 方法 接受 事件 实例 和 失败 的 异 
常 作 为 参数 : 
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class ProcessPodcast implements ShouldQueue 


{ 


use Dispatchable, InteractsWithQueue, Queueable, SerializesM 
odels; 


protected $podcast; 


public $connection = 'redis'; 


public $queue = "test. 


public $delay = 30; 


public $tries 5; 


public $timeout = 30; 
public function __construct(Podcast $podcast) 


{ 
$this->podcast = $podcast; 


public function handle(AudioProcessor $processor ) 


í 


// Process uploaded podcast... 


if (false) { 
$this->release(30); 


public function failed(OrderShipped $event, $exception) 


i 
// 


任务 事件 
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class AppServiceProvider extends ServiceProvider 


{ 


public function boot() 
t 
/ hE jp iE AT RI 
Queue: :before(function (JobProcessing $event) { 
// $event->connectionName 
// $event->job 
// $event ->job->payload( ) 
3); 


// 任 务 运行 后 

Queue: :after(function (JobProcessed $event) { 
// $event->connectionName 
// $event->job 
// $event ->job->payload( ) 

3); 


// 任 务 循环 前 

Queue::looping(function () { 
while (DB::transactionLevel() > 0) { 
DB: :rollBack(); 


3); 


/ MEF AUS 

Queue: :failing(function (JobFailed $event) { 
// $event-»connectionName 
// $event->job 
// $event->exception 


3): 


// RR RAL 

Queue: :exceptionOccurred(function (JobFailed $event) { 
// $event->connectionName 
// $event->job 
// $event->exception 


3): 
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务 的 分 发 


分 发 服务 


e 写 好 任务 类 后 ， 就 能 通过 dispatch 辅助 函数 来 分 发 它 了 。 唯 一 需要 传递 给 
dispatch 的 参数 是 这 个 任务 类 的 实例 : 


class PodcastController extends Controller 


{ 
public function store(Request $request) 
{ 
// 创建 播客 .. 
ProcessPodcast::dispatch($podcast); 
} 
} 


e 如 果 想 延迟 执行 一 个 队列 中 的 任务 ， 可 以 用 任务 实例 的 delay 方法 。 


ProcessPodcast: :dispatch($podcast ) 
->delay(Carbon: :now( )->addMinutes(10)); 


e 通过 推送 任务 到 不 同 的 队列 ， 可 以 给 队列 任务 分 类 ， 甚 至 可 以 控制 给 不 同 的 队 
列 分 配 多 少 任务 。 要 指定 队列 的 话 ， 就 调用 任务 实例 的 onQueue WH: 


ProcessPodcast: :dispatch($podcast ) ->onQueue('processing'); 


e 如 果 使 用 了 多 个 队列 连接 ， 可 以 将 任务 推 到 指定 连接 。 要 指定 连接 的 话 ， 可 以 
在 分 发 任务 的 时 候 使 用 onconnection 方法 : 


ProcessPodcast: :dispatch($podcast)->onConnection('redis 


|)! 


这 些 链 式 的 函数 是 在 trait : Illuminate\Foundation\Bus\Dispatchable 
的 基础 上 应 用 的 ， 该 trait 由 dispatch 函数 启动 : 


trait Dispatchable 


{ 

public static function dispatch() 

{ 

return new PendingDispatch(new static(...func get args() 

)); 

} 
} 
PendingDispatch 类 中 定义 了 链 式 函数 ， 该 函数 巧妙 在 析 构 函数 中 ， 析 构 函 数 自 


动 调 用 全 局 函数 dispatch 


class PendingDispatch 


{ 

public function — construct($job) 

{ 
$this->job = $job; 

} 

public function onConnection($connection) 

{ 
$this->job->onConnection($connection) ; 
return $this; 

} 

public function onQueue($queue ) 

{ 
$this-»job-»onQueue($queue); 
return $this; 

} 

public function delay($delay) 

{ 
$this->job->delay($delay); 
return $this; 

} 

public function _ destruct() 

{ 
dispatch($this->job); 

} 

} 


各 个 函数 里 面 的 onconnection ^ delay ^ onQueue 等 函数 是 任务 中 的 


trait : Illuminate\Bus\Queueable 


trait Queueable 


1 
public function onConnection($connection) 
t 
$this->connection = $connection; 
return $this; 
} 
public function onQueue($queue ) 
{ 
$this->queue = $queue; 
return $this; 
} 
public function delay($delay) 
{ 
$this->delay = $delay; 
return $this; 
J 
} 


dispatch 任务 分 发 源码 


任务 的 分 发 离 不 开 Bus 服务 ， 可 以 利用 全 局 函数 dispatch ， 还 可 以 使 用 


Dispatchable 这 个 trait : 


class Dispatcher implements QueueingDispatcher 


{ 


public function dispatch($command) 
{ 
if ($this->queueResolver && $this->commandShouldBeQueued 
($command)) { 
return $this->dispatchToQueue($command) ; 
} else { 
return $this->dispatchNow($command) ; 


} 
} 
protected function commandShouldBeQueued($command) 
{ 
return $command instanceof ShouldQueue; 
} 
} 
我 们 这 里 主要 看 异步 的 任务 : 


public function dispatchToQueue(S$command) 
{ 

$connection = isset($command->connection) ? $command->connec 
tion : null; 


$queue = call_user_func($this->queueResolver, $connection); 


if (! $queue instanceof Queue) { 
throw new RuntimeException('Queue resolver did not retur 
n a Queue implementation. '); 


j 


if (method exists($command, 'queue')) { 
return $command->queue($queue, $command); 
) else { 
return $this->pushCommandToQueue($queue, $command); 


进行 任务 分 发 之 前 ， 首 先 要 利用 queueResolver 连接 底层 驱动 。 如 果 任 务 类 中 
含有 queue 函数， 那么 就 会 利用 用 户 自己 的 queue 对 驱动 进行 推送 任务 。 否 
则 就 会 启动 默认 的 程序 : 


protected function pushCommandToQueue($queue, $command) 


{ 


if (isset($command->queue, $command->delay)) { 
return $queue->laterOn($command->queue, $command->delay, 
$command); 


} 


if (isset($command->queue)) { 
return $queue->pushOn($command->queue, $command); 


if (isset($command->delay)) { 
return $queue->later($command->delay, $command); 


return $queue->push($command) ; 


我 们 以 redis Al > queue 这 个 类 就 是 Illuminate\Queue\RedisQueue 


class RedisQueue extends Queue implements QueueContract 


{ 


public function push($job, $data = '', $queue = null) 
{ 
return $this->pushRaw($this->createPayload($job, $data), 
$queue); 
} 
public function pushOn($queue, $job, $data = '') 
{ 
return $this->push($job, $data, $queue); 
} 
public function later($delay, $job, $data = '', $queue = nul 
2) 
{ 


return $this->laterRaw($delay, $this->createPayload($job 
, $data), $queue); 


} 
public function laterOn($queue, $delay, $job, $data = '') 
{ 
return $this->later($delay, $job, $data, $queue); 
} 


我 们 先 看 push * push 函数 调用 pushRaw ， 在 调用 之 前 ， 要 把 任务 类 进行 序 
列 化 ， 并 且 以 特定 的 格式 进行 json 序列 化 : 


protected function createPayload($job, $data = '', $queue = null) 
$payload = json_encode($this->createPayloadArray($job, $data 
, $queue)); 


if (JSON_ERROR_NONE !== json_last_error()) { 
throw new InvalidPayloadException; 


return $payload; 


} 
protected function createPayloadArray($job, $data = '', $queue = 
null) 
1 
return is object($job) 
? $this-»createObjectPayload($job) 
: $this->createStringPayload($job, $data); 
} 
protected function createObjectPayload($job) 
{ 
return [ 
'job' => 'IlluminateNQueueNCallQueuedHandlerQcall', 
'maxTries' => isset($job->tries) ? $job->tries : null, 
'timeout' => isset($job->timeout) ? $job->timeout : null 
'data' => [ 
'commandName' => get class($job), 
'command' => serialize(clone $job), 
], 
]; 
} 


protected function createStringPayload($job, $data) 


{ 
return ['job' => $job, 'data' => $data]; 


} 
ee (M 


格式 化 数据 之 后 ， 就 会 将 json 推送 到 redis 队列 中 ， 对 于 非 延 时 的 任务 ， 直 
接 调 用 rpush PP: 


public function pushRaw($payload, $queue = null, array $options 
=P) 
1 

$this->getConnection()->rpush($this->getQueue($queue), $payl 
oad); 


return Arr::get(json decode($payload, true), 'id'); 


对 于 延 时 的 任务 ， 会 调用 laterRaw ° WA redis 的 有 序 集合 zadd BH: 


protected function availableAt($delay = 0) 
{ 
return $delay instanceof DateTimeInterface 
? $delay->getTimestamp() 
: Carbon: :now( )->addSeconds($delay) ->get 
Timestamp(); 


} 


protected function laterRaw($delay, $payload, $queue = null) 
{ 


$this->getConnection( ) ->zadd( 
$this->getQueue($queue).':delayed', $this->availableAt($ 
delay), $payload 
); 


return Arr::get(json decode($payload, true), 'id'); 


这 样 ， 相 关 任 务 就 会 被 分 发 到 redis 对 应 的 队列 中 去 。 
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队列 处 理 器 的 设置 


Laravel 包含 一 个 队列 处 理 器 ， 当 新 任务 被 推 到 队列 中 时 它 能 处 理 这 些 任 务 。 你 
可 以 通过 queue:work 命令 来 运行 处 理 器 。 要 注意 ， 一 旦 queue:work 命令 开 
始 ， 它 将 一 直 运 行 ， 直 到 你 手动 停止 或 者 你 关闭 控制 台 : 

php artisan queue:work 

e 可 以 指定 队列 处 理 器 所 使 用 的 连接 。 

php artisan queue:work redis 

e 可 以 自 定义 队列 处 理 器 ， 方 式 是 处 理 给 定 连 接 的 特定 队列 。 

php artisan queue:work redis --queue=emails 

e 可 以 使 用 --once 选项 来 指定 仅 对 队列 中 的 单一 任务 进行 处 理 : 


php artisan queue:work --once 


e 如 果 一 个 任务 失败 了 ， 会 被 放 入 延 时 队列 中 取 ， --delay 选项 可 以 设置 失败 
任务 的 延 时 时 间 : 


php artisan queue:work --delay=2 


e@ 如 果 想 要 限制 一 个 任务 的 内 存 ， 可 以 使 用 --memory : 


php artisan queue:work --memory=128 


e 当 队 列 需 要 处 理 任务 时 ， 进 程 将 继续 处 理 任 务 ， 它 们 之 间 没 有 延迟 。 但 是 ， 如 
果 没 有 新 的 工作 可 用 ， --sleep 参数 决定 了 工作 进程 将 [睡眠 上 」 多 长 时 
Ja] : 


php artisan queue:work --sleep=3 


e 可 以 指定 Laravel 队列 处 理 器 最 多 执行 多 长 时 间 后 就 应 该 被 关闭 掉 : 


php artisan queue:work --timeout=60 


e 可 以 指定 Laravel 队列 处 理 器 失败 任务 重 试 的 次 数 : 


php artisan queue:work --tries=60 


可 以 看 出 来 ， 队 列 处 理 器 的 设置 大 多 数 都 可 以 由 任务 类 进行 设置 ， 但 是 其 中 三 个 
只 能 由 


sleep ^ delay ^ memory 只 能 由 artisan 来 设置 。 


WorkCommand 4 4-77 2 zl 


任务 处 理 器 进程 的 命令 行 模式 会 调用 
Illuminate\Queue\Console\WorkCommand ， 这 个 类 在 初始 化 的 时 候 依赖 注入 了 


IlluminateNQueueNWorker : 


class WorkCommand extends Command 
{ 
protected $signature = 'queue:work 
{connection? : The name of connectio 
n} 
{--queue= : The queue to listen on} 
{--daemon : Run the worker in daemon 
mode (Deprecated) } 
{--once : Only process the next job 
on the queue} 


Laravel Queue———7H BEA 7| 4E F Ab 9. 25 78.88 Ba 


{--delay=0 : Amount of time to delay 
failed jobs) 

(--force : Force the worker to run e 
ven in maintenance mode) 

{--memory=128 : The memory limit in 
megabytes) 

{--sleep=3 : Number of seconds to sl 
eep when no job is available) 

{--timeout=60 : The number of second 
s a child process can run} 

{--tries=0 : Number of times to atte 
mpt a job before logging it failed}'; 


public function __construct(Worker $worker ) 


{ 
parent::  construct(); 
$this->worker = $worker; 
} 
public function fire() 
t 
if ($this->downForMaintenance() && $this->option('once' ) 
) í 
return $this->worker->sleep($this->option('sleep')); 
} 
$this->listenForEvents(); 
$connection = $this->argument('connection' ) 
?: $this->laravel[ 'config']['queue.defau 
TEE 
$queue = $this-»getQueue($connection); 
$this->runworker ( 
$connection, $queue 
); 
} 
} 


任务 处 理 器 启动 后 ， 会 运行 fire 函数 ， 在 执行 任务 之 前 ， 程 序 首 先 会 注册 监听 
完成 与 任务 失败 的 情况 : 


protected function listenForEvents() 
{ 
$this->laravel['events']->listen(JobProcessed::class, functi 
on ($event) { 
$this->writeOutput($event->job, false); 
3); 


$this->laravel['events']->listen(JobFailed::class, function 
($event) { 
$this->writeOutput($event->job, true); 


$this->logFailedJob($event); 
3): 


protected function writeOutput(Job $job, $failed) 
t 
if ($failed) { 
$this->output ->writeln('<error>['.Carbon: :now()->format ( 
'Y-m-d H:i:s').'] Failed:</error> '.$job->resolveName()); 
} else { 
$this->output ->writeln('<info>['.Carbon: :now()->format(' 
Y-m-d H:i:s').'] Processed:</info> '.$job->resolveName()); 


} 


protected function logFailedJob(JobFailed $event) 
{ 
$this->laravel['queue.failer' ]->log( 
$event->connectionName, $event->job->getQueue(), 
$event->job->getRawBody(), Sevent->exception 


); 





启动 任务 管理 器 runworker ,该 函数 默认 会 调用 Illuminate\Queue\Worker 的 
daemon 元 数 ， 只 有 在 命令 中 强制 --once 参数 的 时 候 ， 才 会 执行 
runNestJob AZ: 


protected function runWorker($connection, $queue) 


{ 
$this-»worker-»setCache($this-»laravel['cache']-»driver()); 
return $this->worker->{$this->option('once') ? 'runNextJob' 
"daemon '}( 
$connection, $queue, $this->gatherworkerOptions() 
); 
} 


Worker 任务 调度 





x timeout 


我 们 接 下 来 接着 看 daemon WA: 


public function daemon($connectionName, $queue, WorkerOptions $0 
ptions) 


1 
$this->listenForSignals(); 


$lastRestart = $this->getTimestampOfLastQueueRestart(); 


while (true) { 
if (! $this->daemonShouldRun($options)) { 
$this->pauseworker($options, $lastRestart); 


continue; 


$job = $this-»getNextJob( 
$this ->manager ->connection($connectionName), $queue 


); 
$this->registerTimeoutHandler($job, $options); 


if ($job) { 

$this->runJob($job, $connectionName, $options); 
) else { 

$this->sleep($options->sleep) ; 


$this->stopIfNecessary($options, $lastRestart); 


言 号 处 理 


listenForSignals HAM T PHP 7.1 版 本 以 上 ， 用 于 脚本 的 信号 处 理 。 所 谓 的 
言 号 处 理 ， 就 是 由 Process Monitor (如 Supervisor ) 发 送 并 与 我 们 的 脚本 
进行 通信 的 异步 通知 。 


protected function listenForSignals() 


{ 
if ($this->supportsAsyncSignals()) { 
pcntl async signals(true); 
pcntl signal(SIGTERM, function () { 
$this->shouldQuit = true; 
3); 
pcntl signal(SIGUSR2, function () { 
$this->paused = true; 
3); 
pcntl signal(SIGCONT, function () { 
$this->paused = false; 
3); 
} 
} 
protected function supportsAsyncSignals() 
{ 
return version_compare(PHP_VERSION, '7.1.0') >= 0 && 
extension loaded('pcntl'); 
} 


pcntl async signals() 被 调用 来 启用 信号 处 理 ， 然 后 我 们 为 多 个 信号 注册 处 
理 程序 : 


e 当 脚 本 被 Supervisor 指示 关闭 时 ， 会 引发 信号 SIGTERM 
e SIGUSR2 是 用 户 定义 的 信号 ，Laravel 用 来 表示 脚本 应 该 暂停 。 
e 当 暂 停 的 脚本 被 Supervisor 指示 继续 进行 时 ， 会 引发 SIGCONT 
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正 运行 任务 之 前 ， 程 序 还 从 cache 中 取 了 一 次 最 后 一 次 重启 的 时 间 : 


protected function getTimestampOfLastQueueRestart() 


{ 
if ($this->cache) { 
return $this->cache->get('illuminate:queue:restart'); 


确定 worker 是 否 应 该 处 理 作 业 


进入 循环 后 ， 首 先 要 判断 当前 脚本 是 应 该 处 理 任务 ， 还 是 应 该 
B 
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protected function daemonShouldRun(WorkerOptions $options) 


{ 


return ! (($this->manager->isDownForMaintenance() && ! $opti 
ons->force) || 
$this->paused || 
$this->events->until(new Events\Looping) === false); 


以 下 几 种 情况 ， 循 环 将 不 会 处 理 任务 : 


e 脚本 处 于 维护 模式 HARA --force 选项 
e 脚本 被 supervisor 暂停 
e 脚本 的 looping 事件 监听 器 返回 false 


looping 事件 监听 器 在 每 次 循环 的 时 候 都 会 被 启动 ， 如 果 返 回 false s: PAH 
前 的 循环 将 会 被 暂停 : pauseworker : 


protected function pauseWorker(WorkerOptions $options, $lastRest 
art) 


{ 


$this->sleep($options->sleep > © ? $options->sleep : 1); 


$this->stopIfNecessary($options, $lastRestart); 


脚本 在 sleep 一 段 时 间 之 后 ， 就 要 重新 判断 当前 脚本 是 否 需要 stop 


protected function stopIfNecessary(WorkerOptions $options, $last 
Restart) 


{ 
if ($this->shouldQuit) { 
$this->kill(); 
} 
if ($this->memoryExceeded($options->memory)) { 
$this->stop(12); 
} elseif ($this->queueShouldRestart($lastRestart)) { 
$this->stop(); 
J 
} 


protected function queueShouldRestart($lastRestart) 
{ 


return $this->getTimestampOfLastQueueRestart() != $lastResta 
(gis 
} 


protected function getTimestampOfLastQueueRestart( ) 


{ 
if ($this->cache) { 
return $this->cache->get('illuminate:queue:restart'); 


以 下 情况 脚本 将 会 被 stop 


e 脚本 被 supervisor 退出 
e 内存 超 限 
e 脚本 被 重启 过 


public function kill($status = 0) 


{ 

if (extension_loaded('posix')) { 
posix_kill(getmypid(), SIGKILL); 

} 
exit($status); 

} 

public function stop($status = 0) 

{ 
$this->events->fire(new Events\WorkerStopping); 
exit ($status); 

} 


脚本 被 重启 ， 当 前 的 进程 需要 退出 并 且 重 新 加 载 。 


获取 下 一 个 任务 


当 含有 多 个 队列 的 时 候 ， 命 令 行 可 以 用 
优先 级 更 高 : 


， 连接 多 个 队列 的 名 字 ， 位 于 前 面 的 队列 


protected function getNextJob($connection, $queue) 
it 
Eny 1 
foreach (explode(',', $queue) as $queue) ( 
if (! is null($job = $connection->pop($queue))) { 
return $job; 


} 
} catch (Exception $e) { 
$this->exceptions->report($e); 
} catch (Throwable $e) { 


$this->exceptions->report(new FatalThrowableError($e) ); 


$connection 是 具体 的 驱动 ， 我 们 这 里 是 IlluminateNQueueNRedisQueue : 


class RedisQueue extends Queue implements QueueContract 


{ 
public function pop($queue = null) 


{ 
$this->migrate($prefixed = $this->getQueue($queue)); 
list($job, $reserved) = $this->retrieveNextJob($prefixed 
); 
if ($reserved) { 
return new RedisJob( 
$this->container, $this, $job, 
$reserved, $this->connectionName, $queue ?: $thi 
s->default 
); 
} 
} 
) 
protected function getQueue($queue) 
1 
return 'queues:'.($queue ?: $this->default); 
} 


在 从 队列 中 取出 任务 之 前 ， 需 要 先 将 delay 队列 和 reserved 队列 中 已 经 到 时 
间 的 任务 放 到 主队 列 中 : 


protected function migrate($queue) 


1 
$this->migrateExpiredJobs($queue.':delayed', $queue); 
if (! is null(S$this-»retryAfter)) { 
$this->migrateExpiredJobs($queue.':reserved', $queue); 
} 
} 


public function migrateExpiredJobs($from, $to) 


{ 


return $this->getConnection() ->eval( 
LuaScripts::migrateExpiredJobs(), 2, $from, $to, $this-> 
currentTime() 


); 


由 于 从 队列 取出 任务 、 在 队列 删除 任务 、 压 入 主队 列 是 三 个 操作 ， 为 了 防止 并 发 ， 
程序 这 里 使 用 了 LUA 脚本 ， 保 证 三 个 操作 的 原子 性 : 
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public static function migrateExpiredJobs() 
{ 
return <<<'LUA' 
-- Get all of the jobs with an expired "score"... 
local val = redis.call('zrangebyscore', KEYS[1], '-inf', 
ARGV[1]) 


-- If we have values in the array, we will remove them f 
rom the first queue 

-- and add them onto the destination queue in chunks of 
100, which moves 

-- all of the appropriate jobs onto the destination queu 
e very safely. 

if(next(val) ~= nil) then 

redis.call('zremrangebyrank', KEYS[1], 0, #val - 1) 


for i- 1, #val, 100 do 
redis.call('rpush', KEYS[2], unpack(val, i, math.mun 
(1-99, #val))) 
end 
end 


return val 
LUA; 


接 下 来 ， 就 要 从 主队 列 中 获取 下 一 个 任务 ， 在 取出 下 一 个 任务 之 后 ， 还 要 将 任务 放 
A reserved 队列 中 ， 妆 任务 执行 失败 后 ， 该 任务 会 进行 重 试 。 
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protected function retrieveNextJob($queue) 


{ 
return $this->getConnection()->eval( 
LuaScripts::pop(), 2, $queue, $queue.':reserved', 
$this->availableAt($this->retryAfter) 
); 
} 


pubI2G static function POPC) 
{ 
return <<<'LUA' 
-- Pop the first job off of the queue... 
local job = redis.call('lpop', KEYS[1]) 
local reserved = false 


if(job ~= false) then 
-- Increment the attempt count and place job on the 
reserved queue... 
reserved = cjson.decode( job) 
reserved['attempts'] = reserved['attempts'] + 1 
reserved = cjson.encode(reserved) 
redis.call('zadd', KEYS[2], ARGV[1], reserved) 


end 


return {job, reserved} 
LUA; 


从 redis 中 获取 到 job 之 后 ， 就 会 将 其 包装 成 RedisJob X: 
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public function __construct(Container $container, RedisQueue $re 
dis, $job, $reserved, $connectionName, $queue) 


{ 
$this->job = $job; 
$this->redis = $redis; 
$this->queue = $queue; 
$this->reserved = $reserved; 
$this->container = $container; 
$this->connectionName = $connectionName; 
$this->decoded = $this-»payload(); 
} 
public function payload() 
{ 
return json_decode($this->getRawBody(), true); 
} 
public function getRawBody() 
{ 
return $this->job; 
} 


超时 处 理 


如 果 一 个 脚本 超时 ，  pcntl alarm 将 会 启动 并 杀 死 当前 的 work HF ° $i 
BE’ work 进程 将 会 被 守护 进程 重启 ， 继 续 进行 下 一 个 任务 。 


protected function registerTimeoutHandler($job, WorkerOptions $0 
ptions) 
{ 

if ($options->timeout > © && $this->supportsAsyncSignals() ) 


pentl_signal(SIGALRM, function () { 
$this->kill(1); 
3); 


pcntl alarm($this-»-timeoutForJob($job, $options) + $opti 
ons-»sleep); 
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protected function timeoutForJob($job, WorkerOptions $options) 


{ 
return $job && ! is null($job->timeout()) ? $job->timeout() 
$options->timeout; 


行 任务 前 后 会 启动 两 个 事件 JobProcessing 与 JobProcessed ， 这 两 个 事件 


protected function runJob($job, $connectionName, WorkerOptions $ 
options) 
{ 


Do 
return $this->process($connectionName, $job, $options); 


} catch (Exception $e) { 
$this->exceptions->report($e); 
} catch (Throwable $e) { 
$this->exceptions->report(new FatalThrowableError($e) ); 


} 
} 
public function process($connectionName, $job, WorkerOptions $op 
tions) 
{ 
try 4 


$this->raiseBeforeJobEvent($connectionName, $job); 


$this-»markJobAsFailedIfAlreadyExceedsMaxAttempts( 
$connectionName, $job, (int) $options-»maxTries 


): 
$job->fire(); 


$this->raiseAfterJobEvent($connectionName, $job); 
} catch (Exception $e) { 
$this->handleJobException($connectionName, $job, $option 
s, $e); 
} catch (Throwable $e) { 
$this->handleJobException( 
$connectionName, $job, $options, new FatalThrowableE 
rror($e) 


): 


raiseBeforeJobEvent Sac TAR AES AERE 
t+ > raiseAfterJobEvent 函数 用 于 触发 任务 处 理 后 的 事件 : 


protected function raiseBeforeJobEvent($connectionName, $job) 


{ 


$this->events->fire(new EventsNJobProcessing( 
$connectionName, $job 


)); 


protected function raiseAfterJobEvent($connectionName, $job) 


{ 


$this->events->fire(new Events\JobProcessed( 
$connectionName, $job 






process 


$job->attempts() <= $maxTries 
$job->markAsFailed() 
$job->delete() 






$job->fire() 





markJobAsFailedIfWillExceed 
MaxAttempts 


$job->attempts() >= 
$maxTries 






no 





$job-»markAsFailed() 


$job->delete() $job->release($options—>delay) 





任务 在 运行 过 程 中 会 遇 到 异常 情况 ， 这 个 时 候 就 要 判断 当前 任务 的 失败 次 数 是 不 是 
超过 限制 。 如 果 没 有 超过 限制 ， 那 么 就 会 把 当前 任务 重新 放 回 队列 当中 ; 如 果 超 过 
了 限制 ， 那 么 就 要 标记 当前 任务 为 失败 任务 ， 并 且 将 任务 从 reserved 队列 中 删 
除 。 


任务 失败 


markJobAsFailedIfAlreadyExceedsMaxAttempts axl THE Fiat Ay > F 
当前 任务 是 否 重 试 次 数 超 过 限制 : 
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protected function markJobAsFailedIfAlreadyExceedsMaxAttempts ($c 
onnectionName, $job, $maxTries) 


1 
$maxTries = ! is null($job-»maxTries()) ? $job->maxTries() 
$maxTries; 
if ($maxTries === 0 || $job->attempts() <= $maxTries) ( 
return; 
} 


$this->failJob($connectionName, $job, $e = new MaxAttemptsEx 
ceededException( 
'A queued job has been attempted too many times. The job 
may have previously timed out.' 


)); 


throw $e; 
} 
public function maxTries() 
{ 
return array_get($this->payload(), 'maxTries'); 
} 
public function attempts() 
{ 
return Arr::get($this->decoded, 'attempts') + 1; 
} 


protected function failJob($connectionName, $job, $e) 


{ 


return FailingJob: :handle($connectionName, $job, $e); 


当 遇 到 重 试 次 数 大 于 限制 的 任务 ， work 进程 就 会 调用 FailingJob : 


protected function failJob($connectionName, $job, $e) 


{ 


return FailingJob: :handle($connectionName, $job, $e); 


public static function handle($connectionName, $job, $e = null) 


{ 
$job->markAsFailed(); 


if ($job->isDeleted()) ( 
return; 


try { 
$job->delete(); 


$job->failed($e); 
J finally f 
static::events()-»fire(new JobFailed( 
$connectionName, $job, $e ?: new ManuallyFailedExcep 


tion 
)); 
j 
} 
public function markAsFailed() 
{ 
$this->failed = true; 
} 
public function delete() 
{ 
parent: :delete(); 
$this->redis->deleteReserved($this->queue, $this); 
} 


public function isDeleted( ) 


{ 


return $this->deleted; 


FailingJob 会 标记 当前 任务 failed ^ deleted ， 并 且 会 将 当前 任务 移 除 
reserved 队列 ， 不 会 再 重 试 : 


public function deleteReserved($queue, $job) 


{ 


$this->getConnection()->zrem($this->getQueue($queue).': reser 
ved', $job->getReservedJob()); 
} 


FailingJob 还 会 调用 RedisJob 的 failed 


鸥 数 ， 并 且 触 发 JobFailed 
事件 : 


public function failed($e) 


{ 
$this->markAsFailed(); 
$payload = $this->payload(); 
list($class, $method) = JobName::parse($payload['job']); 
if (method_exists($this->instance = $this->resolve($class), 
'failed')) { 
$this->instance->failed($payload['data'], $e); 
} 
} 


程序 会 解析 job 类 ， 我 们 先前 在 redis 中 已 经 存储 了 : 


'job' => 'IlluminateNQueueNCallQueuedHandlerQcall', 
'maxTries' => isset($job->tries) ? $job->tries : null, 
'timeout' => isset($job->timeout) ? $job->timeout : null, 
'data' => [ 
'commandName' -» get class($job), 
'command' => serialize(clone $job), 


Ip 
1; 


我 们 接着 看 failed HK: 


public function failed(array $data, $e) 


{ 
$command = unserialize($data['command']); 
if (method_exists($command, 'failed')) { 
$command ->failed($e) ; 
} 
} 


可 以 看 到 ， 最 后 程序 调用 了 任务 类 的 failed He 


异常 处 理 


当 任 务 遇 到 异常 的 时 候 ， 程 序 仍然 会 判断 当前 任务 的 重 试 次 数 ， 如 果 本 次 任务 的 重 
试 次 数 已 经 大 于 或 等 于 限制 ， 那 么 就 会 停止 重 试 ， 标 记 为 失败 ; 否则 就 会 重新 放 入 
队列 9 记录 日 志 mW ° 


protected function handleJobException($connectionName, $job, Wor 
kerOptions $options, $e) 
t 
bey d 
$this-»markJobAsFailedIfWillExceedMaxAttempts( 
$connectionName, $job, (int) $options->maxTries, $e 


); 


$this->raiseExceptionOccurredJobEvent ( 
$connectionName, $job, $e 
); 
) finally ( 
if (! $job->isDeleted()) { 
$job->release($options->delay); 


throw $e; 


protected function markJobAsFailedIfwillExceedMaxAttempts($conne 
ctionName, $job, $maxTries, $e) 


{ 
$maxTries = ! is_null($job->maxTries()) ? $job->maxTries() 
$maxTries; 
if ($maxTries > 0 && $job->attempts() >= $maxTries) { 
$this->failJob($connectionName, $job, $e); 
} 
} 
public function release($delay = 0) 
{ 
parent::release($delay); 
$this->redis->deleteAndRelease($this->queue, $this, $delay); 
} 


public function deleteAndRelease($queue, $job, $delay) 
{ 


$queue = $this->getQueue($queue) ; 


$this-»-getConnection()-»eval( 
LuaScripts::release(), 2, $queue.':delayed', $queue.':re 
served', 
$job->getReservedJob(), $this->availableAt ($delay ) 
); 


— 9. 4t 4- HIF HHI o PABEFHALZAM reserved 队列 放 入 delayed 
队列 ， 并 且 抛 出 异常 ， 抛 出 异常 后 ， 程 序 会 将 其 记录 在 日 志 中 。 
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public static function release() 


{ 
return <<<'LUA' 
-- Remove the job from the current queue... 
redis.call('zrem', KEYS[2], ARGV[1]) 
-- Add the job onto the "delayed" queue... 
redis.call('zadd', KEYS[1], ARGV[2], ARGV[1]) 
return true 
LUA; 
j 
Ne A- 
任务 的 运 和 


任务 的 运行 首先 会 调用 callQueuedHandler 的 call Hx: 
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public function fire() 
{ 
$payload = $this->payload(); 


list($class, $method) = JobName::parse($payload['job']); 


with($this->instance = $this->resolve($class) )->{$method}($t 
his, $payload['data']); 


} 
public function call(Job $job, array $data) 
{ 
$command = $this->setJobInstanceIfNecessary( 
$job, unserialize($data['command']) 
); 
$this->dispatcher ->dispatchNow( 
$command, $handler = $this->resolveHandler($job, $comman 
d) 
); 
if (! $job->isDeletedOrReleased()) { 
$job->delete(); 
} 
} 


setJobInstancelfNecessary 函数 用 于 为 任务 类 的 trait : 
InteractswithQueue 的 设置 任务 类 : 


protected function setJobInstanceIfNecessary(Job $job, $instance) 


if (in array(InteractsWithQueue::class, class uses recursive 
(get class(S$instance)))) { 
$instance->setJob($job); 


} 
return $instance; 
} 
trait InteractsWithQueue 
{ 
public function setJob(JobContract $job) 
{ 
$this->job = $job; 
return $this; 
} 
} 


E ey Di 


接着 任务 的 运行 就 要 交 给 dispatch 


public function dispatchNow($command, $handler = null) 
{ 
if ($handler || $handler = $this->getCommandHandler ($command 
)) { 
$callback = function ($command) use ($handler) { 
return $handler->handle($command) ; 
3 
) else { 
$callback = function ($command) { 
return $this->container->call([$command, 'handle']); 


ia 


return $this->pipeline->send($command) ->through($this->pipes 
)->then($callback); 
} 


public function getCommandHandler ($command ) 
{ 
if ($this->hasCommandHandler($command)) { 
return $this->container ->make($this->handlers[get_class( 
$command) ] ); 


} 
return false; 
} 
public function hasCommandHandler ($command) 
{ 
return array_key_exists(get_class($command), $this->handlers 
); 
} 


如 果 不 对 dispatcher 类 进行 任何 map ZEE OO 将 
会 返回 null ， 此 时 就 会 调用 任务 类 的 handle 函数 ， 进 行 具 体 的 业务 逻辑 。 


任务 结束 后 ， 就 会 调用 delete BA: 


public function delete() 


{ 
parent: :delete(); 


$this->redis->deleteReserved($this->queue, $this); 


public function deleteReserved($queue, $job) 


t 
$this->getConnection()->zrem($this->getQueue($queue).': reser 
ved', $job->getReservedJob()); 


} 


这 样 ， 和 运行 成 功 的 任务 会 从 reserved 中 删除 。 
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在 现代 的 web 应 用 程序 中 ， WebSockets 被 用 来 实现 需要 实时 、 即 时 更 新 的 接 
口 。 当 服务 器 上 的 数据 被 更 新 后 ， 更 新 信息 将 通过 WebSocket 连接 发 送 到 客户 


A 


端 等 待 处 理 。 相 比 于 不 停 地 轮 询 应 用 程序 ， WebSocket 是 一 种 更 加 可 靠 和 高 效 的 


我 们 先 用 一 个 电子 商务 网 站 作为 例子 来 概览 一 下 事件 广播 。 当 用 户 在 查看 自己 的 订 
单 时 ， 我 们 不 希望 他 们 必须 通过 刷新 页 面 才能 看 到 状态 更 新 。 我 们 希望 一 旦 有 更 新 
时 就 主动 将 更 新 信息 广播 到 客户 端 。 


laravel 的 广播 系统 和 队列 系统 类 似 ， 需 要 两 个 进程 协作 ， 一 个 是 laravel 

的 web 后 台 系 统 ， 另 一 个 是 Socket.I0 服务 器 系统 。 具 体 的 流程 是 页 面 加 载 
时 ， 网 页 js 程序 Laravel Echo 4 Socket.IO 服务 器 建立 连接 ， 

laravel 发 起 通过 驱动 发 布 广播 ， Socket.I0 服务 器 接受 广播 内 容 ， 对 连接 的 
客户 端 网 页 推送 信息 ， 以 达到 网 页 实时 更 新 的 目的 。 


laravel 发 起 广播 的 方式 有 两 种 ， redis 与 pusher 。 对 于 redis 来 说 ， 
需要 支持 Socket.10 服务 器 系统 ， 官 方 推荐 nodejs 为 底层 的 
tlaverdure/laravel-echo-server 。 对 于 pusher 来 说 ， 该 第 三 方 服务 包含 
了 了 驱动 与 Socket.IO 服务 器 。 


本 文 将 会 介绍 redis 为 驱动 的 广播 源码 ， 由 于 laravel-echo-server 是 
nodejs 编写 ， 本文 也 无 法 介绍 Socket.IO 方面 的 内 容 。 
广播 系统 服务 的 户 动 


和 其 他 服务 类 似 ， 广 播 系统 服务 的 注册 实质 上 就 是 对 Ioc 容器 注册 门面 类 ， 广 播 
系统 的 门面 类 是 BroadcastManager : 


class BroadcastServiceProvider extends ServiceProvider 


{ 


public function register() 


{ 


$this->app->singleton(BroadcastManager::class, function 


(Sapp) { 
return new BroadcastManager($app); 


3); 


$this->app->singleton(BroadcasterContract::class, functi 


on ($app) 1 
return $app-»make(BroadcastManager::class)-»connecti 


on(); 


3); 


$this-»app-»alias( 
BroadcastManager::class, BroadcastingFactory::class 


): 


除了 注册 BroadcastManager * BroadcastServiceProvider 还 进行 了 广播 驱 
动 的 启动 : 


public function connection($driver = null) 


{ 
return $this->driver($driver); 
} 
public function driver($name = null) 
{ 
$name = $name ?: $this->getDefaultDriver(); 
return $this->drivers[$name] = $this->get($name); 
} 


protected function get($name) 


{ 


return isset($this->drivers[$name]) ? $this->drivers[$name] 


$this->resolve($name) ; 


protected function resolve($name ) 


{ 
$config = $this->getConfig($name) ; 


if (is_null($config)) { 
throw new InvalidArgumentException("Broadcaster [{$name} 
] is not defined."); 


} 


if (isset($this->customCreators[$config['driver']])) { 
return $this->callCustomCreator($config); 


$driverMethod = 'create'.ucfirst($config['driver']).'Driver' 


if (! method_exists($this, $driverMethod)) { 
throw new InvalidArgumentException("Driver [($config['dr 
iver']}] is not supported."); 
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return $this->{$driverMethod}($config); 


protected function createRedisDriver(array $config) 
{ 
return new RedisBroadcaster( 
$this->app->make('redis'), Arr::get($config, 'connection' 


广播 信息 的 发 布 与 事件 的 发 布 大 致 相同 ， 要 告知 Laravel 一 个 给 定 的 事件 是 广播 
类 型 ， 只 需 在 事件 类 中 实现 
Illuminate\Contracts\Broadcasting\ShouldBroadcast 接口 即 可 。 该 接口 
已 经 被 导入 到 所 有 由 框架 生成 的 事件 类 中 ， 所 以 可 以 很 方便 地 将 它 添加 到 自己 的 事 
件 中 。 


ShouldBroadcast 接口 要 求 你 实现 一 个 方法 : broadcastOn . broadcaston 
方法 返回 一 个 频道 或 一 个 频道 数组 ， 事 件 会 被 广播 到 这 些 频 道 。 频 道 必须 是 
Channel ^ PrivateChannel 或 PresenceChannel 的 实例 。 Channel 实例 
表示 任何 用 户 都 可 以 订阅 的 公开 频道 ， 而 PrivateChannels 和 
PresenceChannels 则 表示 需要 频道 授权 的 私有 频道 


class ServerCreated implements ShouldBroadcast 


{ 


use SerializesModels; 

public $user; 

// 黑 认 情 况 下 ， 每 一 个 广播 事件 都 被 添加 到 黑 认 的 队列 上 ， 黑 认 的 队列 连接 在 qu 
eue.php 配置 文件 中 指定 。 可 以 通过 在 事件 类 中 定义 一 个 broadcastQueue 属性 来 
自 定义 广播 器 使 用 的 队列 。 该 属性 用 于 指定 广播 使 用 的 队列 名 称 : 


public $broadcastQueue = 'your-queue-name'; 


public function __construct(User $user) 


{ 
$this->user = $user; 
} 
public function broadcaston( ) 
{ 
return new PrivateChannel('user.'.$this-»user-»id); 
} 


//Laravel 默认 会 使 用 事件 的 类 名 作为 广播 名 称 来 广播 事件 ， 自 定义 : 
public function broadcastAs() 


( 


return 'server.created'; 


// 想 更 细 粒 度 地 控制 广播 数据 : 
public function broadcastwith() 


{ 


return ['id' => $this->user->id]; 


// 有 时 ， 想 在 给 定 条 件 为 true ， 才 广播 事件 ;: 
public function broadcastWhen() 


| 


return $this->value > 100; 


然后 ， 只 需要 像 平时 那样 触发 事件 。 一 旦 事件 被 触发 ， 一 个 队列 任务 会 自动 广播 事 
件 到 你 指定 的 广播 驱动 器 上 。 


当 一 个 事件 被 广播 时 ， 它 所 有 的 public 属性 会 自动 被 序列 化 为 广播 数据 ， 这 允 
许 你 在 你 的 Javascript 应 用 中 访问 事件 的 公有 数据 。 因 此 ， 举 个 例子 ， 如 果 你 
的 事件 有 一 个 公有 的 $user 属性 ， 它 包含 了 一 个 Elougent 模型 ， 那 么 事件 的 
广播 数据 会 是 : 


"user to 人 
pe do pd D 
"name": "Patrick Stewart" 


广播 发 布 的 源码 


广播 的 发 布 与 事件 的 触发 是 一 体 的 ， 具 体 的 流程 我 们 已 经 在 event 的 源码 中 介绍 
清楚 了 ， 现 在 我 们 来 看 唯一 的 不 同 : 


public function dispatch($event, $payload = [], $halt = false) 


{ 
list($event, $payload) = $this->parseEventAndPayload( 
$event, $payload 
); 
if ($this->shouldBroadcast($payload)) { 
$this->broadcastEvent ($payload[0]); 
J 
J 


protected function shouldBroadcast(array $payload) 


{ 
return isset($payload[0]) && $payload[0] instanceof Shou 


ldBroadcast; 


j 


protected function broadcastEvent(S$event) 


( 


$this-»container-»make(BroadcastFactory::class)-»queue($ 
event); 


j 


可 见 ， 关 键 之 处 在 于 BroadcastManager 的 quene 方法 : 


public function queue($event ) 


{ 


$connection = $event instanceof ShouldBroadcastNow ? 'sync' 
cog TUB E 


if (is null($connection) && isset($event->connection)) { 
$connection = $event->connection; 


$queue = null; 


if (isset($event->broadcastQueue)) { 
$queue = $event->broadcastQueue; 

} elseif (isset($event->queue)) { 
$queue = $event->queue; 


$this->app->make( 'queue' )->connection($connection) ->pushOn( 
$queue, new BroadcastEvent(clone $event) 


); 


可 见 ， quene 方法 将 广播 事件 包装 为 事件 类 ， 并 且 通 过 队列 发 布 ， 我 们 接 下 来 看 
这 个 事件 类 的 处 理 : 


class BroadcastEvent implements ShouldQueue 


{ 
public function handle(Broadcaster $broadcaster ) 
{ 
$name = method_exists($this->event, 'broadcastAs' ) 
? $this->event->broadcastAs() : get_class($this- 
>event); 


$broadcaster ->broadcast ( 
array_wrap($this->event->broadcastOn()), $name, 
$this->getPayloadFromEvent ($this->event ) 

); 


protected function getPayloadFromEvent ($event ) 
{ 
if (method_exists($event, 'broadcastWith')) { 
return array_merge( 
$event->broadcastwith(), ['socket' => data get($ 
event, 'socket')] 


); 


$payload = []; 


foreach ((new ReflectionClass($event) )->getProperties(Re 
flectionProperty::IS PUBLIC) as $property) { 
$payload[$property->getName()] = $this->formatProper 
ty($property->getValue($event) ); 


} 
return $payload; 
J 
protected function formatProperty($value) 
{ 
if ($value instanceof Arrayable) { 
return $value->toArray(); 
} 
return $value; 
} 


可 见 该 事件 主要 调用 broadcaster 的 broadcast 方法 ， 我 们 这 里 讲 redis 
的 发 布 : 


class RedisBroadcaster extends Broadcaster 
{ 


public function broadcast(array $channels, $event, array $pa 
yload = []) 


x 
$connection = $this->redis->connection($this->connection 
); 
$payload - json encode([ 
'event' => $event, 
'data' => $payload, 
'socket' => Arr::pull($payload, 'socket'), 
1); 
foreach ($this->formatChannels($channels) as $channel) { 
$connection->publish($channel, $payload); 
} 
} 
} 


protected function formatChannels(array $channels) 
{ 
return array_map(function ($channel) { 
return (string) $channel; 
), $channels); 


broadcast 方法 运用 了 redis 的 publish 方法 ， 对 redis 进行 了 频道 的 
信息 发 布 。 


频道 授权 


对 于 私有 频道 ， 用 户 只 有 被 授权 后 才能 监听 。 实 现 过 程 是 用 户 向 Laravel 应 用 程 
序 发 起 一 个 携带 频道 名 称 的 HTTP 请求， 应 用 程序 判断 该 用 户 是 否 能 够 监听 该 频 
道 。 在 使 用 Laravel Echo 时 ， 上 述 HTTP 请 求 会 被 自动 发 送 ; 尽管 如 此 ， 仍 
然 需要 定义 适当 的 路 由 来 响应 这 些 请求 。 


定义 授权 路 由 
我 们 可 以 在 Laravel 里 很 容易 地 定义 路 由 来 响应 频道 授权 请 求 。 


Broadcast::routes(); 


Broadcast::routes 方法 会 自动 把 它 的 路 由 放 进 web 中 间 件 组 中 ; 另外 ， 如 
果 你 想 对 一 些 属 性 自 定 义 ， 可 以 向 该 方法 传递 一 个 包含 路 由 属性 的 数组 


Broadcast::routes($attributes); 


定义 授权 回调 


接 下 来 ， 我 们 需要 定义 真正 用 于 处 理 频 道 授 权 的 逻辑 。 这 是 在 
routes/channels.php 文件 中 完成 。 在 该 文件 中 ， 你 可 以 用 
Broadcast::channel 方法 来 注册 频道 授权 回调 函数 : 


Broadcast::channel('order.([orderId)', function ($user, $orderId) 


return $user->id === Order: :findOrNew($orderId) ->user_id; 


[rj | || 


channel 方法 接收 两 个 参数 : 频道 名 称 和 一 个 回调 函数 ， 该 回调 通过 返回 
true 或 false 来 表示 用 户 是 否 被 授权 监听 该 频道 。 


所 有 的 授权 回调 接收 当前 被 认证 的 用 户 作 为 第 一 个 参数 ， 任 何 额 外 的 通配符 参数 作 
为 后 续 参 数 。 在 本 例 中 ， 我 们 使 用 {orderId} 占 位 符 来 表示 频道 名 称 的 【IDI1 


日 


部 分 是 通配符 。 


授权 回调 模型 绑 定 


就 像 HTTP 路 由 一 样 ， 频 道路 由 也 可 以 利用 显 式 或 隐 式 路 由 模型 绑 定 。 例 如 ， 相 
比 于 接收 一 个 字符 串 或 数字 类 型 的 order ID ， 你 也 可 以 请 求 一 个 真正 的 
Order 模型 实例 : 


Broadcast: :channel('order.{order}', function ($user, Order $orde 


DE! 


return $user->id === $order-»user id; 


3); 


频道 授权 源码 分 析 
授权 路 由 


class BroadcastManager implements FactoryContract 


{ 


public function routes(array $attributes = null) 


{ 
if ($this->app->routesAreCached()) ( 
return; 
} 
$attributes = $attributes ?: ['middleware' => ['web']]; 
$this->app['router']->group($attributes, function ($rout 
er) { 


$router->post('/broadcasting/auth', BroadcastControl 
ler::class.'@authenticate'); 


J); 


频道 专门 有 Controller 来 处 理 授权 服务 : 


class BroadcastController extends Controller 


1 
public function authenticate(Request $request) 
{ 
return Broadcast: :auth($request); 
J 


4 Socket Io 服务 器 对 javascript 程序 推送 数据 的 时 候 ， 首 先 会 经 过 该 
controller 进行 授权 验证 : 


public function auth($request) 
{ 
if (Str::startswith($request->channel_name, ['private-', 'pr 
esence-']) && 
! $request->user()) { 
throw new HttpException( 403); 


$channelName = Str::startsWith($request->channel_name, ‘priv 
ate-') 
? Str::replaceFirst('private-', '', $req 
uest->channel_name) 
Str::replaceFirst('presence-', '', $re 
quest-»channel name); 


return parent::verifyUserCanAccessChannel( 
$request, $channelName 


): 


ve Meer anecon ned 根据 频道 与 其 绑 定 的 闭 包 元 数 来 验证 该 频道 是 否 
可 以 通过 授权 : 


protected function verifyUserCanAccessChannel($request, $channel) 


foreach ($this->channels as $pattern => $callback) { 
if (! Str::is(preg replace('/\{(.*?)\}/', '*', $pattern) 
, $channel)) { 
continue; 


$parameters = $this->extractAuthParameters($pattern, $ch 
annel, $callback); 


if ($result = $callback($request->user(), ...$parameters 
)) { 
return $this->validAuthenticationResponse($request, 
$result); 
} 
} 


throw new HttpException( 403); 


ES 


由 于 频道 的 命名 经 常 带 有 userid 等 参数 ， 因 此 判断 频道 之 前 首先 要 把 
channels 中 的 频道 名 转 为 通配符 * ， 例 如 order.{userid} 转 为 order.*， 
之 后 进行 正则 匹配 。 


extractAuthParameters 用 于 提取 频道 的 闭 包 函数 的 参数 ， 合 并 $request- 
>user() 之 后 调用 闭 包 有 函数 。 


protected function extractAuthParameters($pattern, $channel, $ca 
llback) 
{ 

$callbackParameters = (new ReflectionFunction($callback ) )->g 
etParameters(); 


return collect($this-»-extractChannelKeys($pattern, $channel) 
)-»reject(function ($value, $key) { 
return is numeric(S$key); 
})->map(function ($value, $key) use ($callbackParameters) { 
return $this->resolveBinding($key, $value, $callbackPara 
meters); 
})->values()->all(); 


protected function extractChannelKeys($pattern, $channel) 


t 
preg match('/^'.preg replace('/N((.*?)N)/', '(?<$1>[4\.]+)', 
$pattern).'/', $channel, $keys); 


return $keys; 


public function validAuthenticationResponse($request, $result) 


{ 
if (is_bool($result)) { 
return json encode($result); 


return json encode(['channel data' => [ 
'user id' => $request->user()->getKey(), 
'user info' -» $result, 


11); 


extractchannelKeys 用 于 将 order.{userid} 5 order.23 中 userid 
fe 23 建立 key ^ value 关联 。 如 果 userid 是 User HE 
$> resolveBinding 还 可 以 为 其 自动 进行 路 由 模型 绑 定 。 
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Laravel Passport—— —OAuth2 API 认证 系统 
源码 解析 (E) 


在 Laravel 中 ， 实 现 基于 传统 表单 的 登陆 和 授权 已 经 非常 简单 ， 但 是 如 何 满足 API 
场景 下 的 授权 需求 呢 ? 在 API 场景 里 通常 通过 令 牌 来 实现 用 户 授 权 ， 而 非 维护 请 求 
之 间 的 Session 状态 。 在 Laravel 项 目 中 使 用 Passport 可 以 轻而易举 地 实现 API 
授权 认证 ，Passport 可 以 在 几 分 钟 之 内 为 你 的 应 用 程序 提供 完整 的 OAuth2 服务 端 
KIL o 


首先 我 们 可 以 先 了 解 一 下 OAuth2 : 理解 OAuth 2.0 


可 以 看 出 来 ，OAuth2 的 授权 模式 分 为 4 种 ， 相 应 的 Passport 的 授权 模式 也 是 4 
中 。 下 面 ， 我 们 就 会 逐一 进行 源码 分 析 。 


Passport 服务 的 注册 启动 


class PassportServiceProvider extends ServiceProvider 
public function register() 


$this->registerAuthorizationServer(); 
$this->registerResourceServer(); 


$this-»registerGuard(); 


我 们 知道 OAuth2 KAW 客户 ` ZPR 、 认证 服务 器 ` 资源 服务 器 FH 
成 。 在 这 里 ， 我 们 扮演 着 认证 服务 器 5 资源 服务 器 的 角色 。 


认证 服务 器 注册 


protected function registerAuthorizationServer ( ) 


{ 


$this->app->singleton(AuthorizationServer::class, function () 


return tap($this->makeAuthorizationServer(), function ($ 
server) ( 
$server-»enableGrantType( 
$this->makeAuthCodeGrant(), Passport::tokensExpi 
reIn() 
); 


$server-»enableGrantType( 
$this->makeRefreshTokenGrant(), Passport::tokens 
ExpireIn() 
); 


$server-»enableGrantType( 
$this->makePasswordGrant(), Passport::tokensExpi 


reIn() 
); 
$server-»enableGrantType( 
new PersonalAccessGrant, new DateInterval( 'PiY') 
); 
$server-»enableGrantType( 
new ClientCredentialsGrant, Passport::tokensExpi 
reIn() 


); 


if (Passport::$implicitGrantEnabled) { 
$server ->enableGrantType( 
$this->makeImplicitGrant(), Passport::tokens 
ExpireIn() 
); 


3); 








4] 01 




















iz 


AuthorizationServer 认证 服务 器 是 League OAuth2 server 的 一 个 类 ， 是 
League 关于 OAuth2 的 实现 类 。 这 个 认证 服务 器 类 需要 5 个 参数 ， 分 别 代 表 
客户 端 ^ token 令 牌 ^ scope 作用 范围 ^ 加 密 私 钥 ` 加 密 key ° 


class AuthorizationServer implements EmitterAwareInterface 
t 
public function — construct( 
ClientRepositoryInterface $clientRepository, 
AccessTokenRepositoryInterface $accessTokenRepository, 
ScopeRepositoryInterface $scopeRepository, 
$privateKey, 
$encryptionKey, 
ResponseTypelInterface $responseType = null 
) d 
$this->clientRepository = $clientRepository; 
$this->accessTokenRepository = $accessTokenRepository; 
$this->scopeRepository = $scopeRepository; 


if ($privateKey instanceof CryptKey === false) { 
$privateKey = new CryptKey($privateKey); 

} 

$this->privateKey = $privateKey; 

$this-»-encryptionKey = $encryptionkey; 

$this->responseType = $responseType; 


这 些 不 同 的 Repository 均 是 各 个 接口 类 ， 这 些 类 规定 了 各 个 部 分 的 功 
能 。 Passport 实现 了 上 述 几 个 接口 类 : 


public function makeAuthorizationServer ( ) 


1 
return new AuthorizationServer( 
$this->app->make(Bridge\ClientRepository::class), 
$this->app->make(Bridge\AccessTokenRepository::class), 
$this->app->make(Bridge\ScopeRepository::class), 
$this->makeCryptKey('oauth-private.key'), 
app('encrypter')-»getKey() 
); 
jy 
protected function makeCryptKey($key) 
t 
return new CryptKey( 
'file://'.Passport::keyPath($key), 
null, 
false 
); 
} 


oauth-private.key 这 个 私 钥 由 php artisan passport:keys 命令 生 
成 。 encrypter 的 加 密 key 是 ,env 文件 的 key 属性 。 


构建 认证 服务 器 之 后 ， 还 要 对 认证 服务 器 注册 授权 方式 。 Passport 的 授权 方式 
有 传统 的 OAuth2 : 授权 码 模式 ` 密码 模式 + BARA 、 客户 端 模式 ， 还 有 
刷新 令 牌 模式 、 个 人 授权 模式 等 。 


protected function makeAuthCodeGrant( ) 


{ 
return tap($this->buildAuthCodeGrant(), function ($grant) { 
$grant->setRefreshTokenTTL(Passport: :refreshTokensExpire 
In()); 
3); 
} 
protected function buildAuthCodeGrant() 
{ 
return new AuthCodeGrant ( 
$this->app->make(Bridge\AuthCodeRepository::class), 
$this->app->make(Bridge\RefreshTokenRepository: :class), 
new DateInterval('PT10M' ) 
); 
} 


资源 服务 器 注册 


X487, ResourceServer 也 是 League 的 资源 服务 器 类 : 


protected function registerResourceServer() 


1 
$this->app->singleton(ResourceServer::class, function () { 
return new ResourceServer ( 
$this->app->make(Bridge\AccessTokenRepository::class 
), 
$this->makeCryptKey( 'oauth-public.key' ) 
); 
3): 
} 


guard 注册 


当 我 们 已 经 构建 好 Passport 服务 之 后 ， 我 们 只 要 利用 中 间 件 Auth:api 就 可 
以 利用 Passport 验证 api 的 合法 性 。 具 体 的 原理 是 中 间 件 auth 的 参数 
api 是 指定 guard 的 名 称 ， 例 如 web ^ api ,如 果 调 用 的 是 api 的 


guard 那么 就 会 创建 相应 的 passport 驱动 器 : 


'guards' => [ 

'web' => [ 
'driver' => 'session', 
'provider' => 'users', 


], 
'api' => [ 
'driver' => 'passport', 
'provider' => 'users', 
] 


], 


而 passport guard 驱动 器 就 是 这 个 TokenGuard : 


protected function registerGuard() 


( 


Auth::extend('passport', function ($app, $name, array $confi 


g) i 


return tap($this->makeGuard($config), function ($guard) 


{ 
$this->app->refresh('request', $guard, 'setRequest' ) 
3); 
3); 
E 
protected function makeGuard(array $config) 
{ 
return new RequestGuard(function ($request) use ($config) ( 
return (new TokenGuard( 
$this->app->make(ResourceServer::class), 
Auth: :createUserProvider($config[ 'provider']), 
$this->app->make(TokenRepository::class), 
$this->app->make(ClientRepository::class), 
$this->app->make('encrypter' ) 
))-»user($request); 
}, $this-»app['request']); 
} 


授权 码 模 式 
授权 码 模 式 大 概 分 为 5 个 步骤 


e PAA 向 我 们 的 服务 器 申请 创建 客户 端 。 

e 用 户 打 开 客 户 端 以 后 ， 客 户 端 会 跳 转 到 我 们 的 网 站 授权 页 面 要 求 用 户 给 予 授 
权 。 

e 用 户 同 意 给 予 客户 端 ， 我 们 将 会 返回 授权 码 o 

e 客户 ee， ne 向 认证 服务 器 申请 令 牌 。 

e 客户 端 使 用 令 牌 ， 向 资源 服务 器 申请 获取 资源 。 


为 何 授权 码 模 式 需 要 如 此 设置 步骤 可 以 查看 : Why is there an “Authorization Code" 
flow in OAuth2 when “Implicit” flow works so well? * OAuth25£ 7] f£ - 


在 创建 客户 端 这 一 步骤 ， 第 三 方 需要 提供 客户 端 名 称 与 客户 端的 redirect 


const data = { 

name: 'Client Name', 

redirect: 'http://example.com/callback' 
}; 


axios.post('/oauth/clients', data) 
.then(response => { 
console.log(response.data); 
3) 
.catch (response => { 
// List errors on response... 


3); 


我 们 在 创建 成 功 之 后 ， 会 返回 此 客户 端的 ID 和 密 铀 。 这 两 个 东西 十 分 重要 ， 是 
后 面 几 个 步骤 必要 的 参数 。 


public function forClients() 
{ 
$this->router->group(['middleware' => ['web', 'auth']], func 
tion ($router) ( 
$router->get('/clients', [ 
'uses'! => 'ClientControllerQforUser', 


1); 


$router-»post('/clients', [ 
'uses'! => 'ClientController@store', 


1); 


$router->put('/clients/{client_id}', [ 
'uses' => 'ClientController@update', 


]); 


$router->delete('/clients/{client_id}', [ 
'uses' => 'ClientController@destroy', 


1); 


3): 


} 
public function store(Request $request) 
{ 
$this->validation->make($request->all(), [ 
'name' => 'required|max:255', 
'redirect' => 'required|url', 
])->validate(); 
return $this->clients->create( 
$request ->user()->getKey(), $request->name, $request->re 
direct 
)-»makeVisible('secret'); 
} 


public function create($userId, $name, $redirect, $personalAcces 
s = false, $password = false) 
{ 
$client = (new Client) ->forceFill([ 
'user id' => $userId, 
'name' -» $name, 
'secret' -» str random(40), 
'redirect' -» $redirect, 
'personal access client' => $personalAccess, 
'password client' -» $password, 
'revoked' => false, 


1); 
$client->save(); 


return $client; 


跳 转 授权 页 面 


客户 端 创建 之 后 ， 开 发 者 会 使 用 此 客户 端的 ID 和 密 钥 来 请 求 授 权 代 码 ， 并 从 应 用 
程序 访问 令 牌 。 首 先 ， 接 入 应 用 的 用 户 向 你 应 用 程序 的 /oauth/authorize 路 由 发 出 
重 定向 请 求 ， 
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Route::get('/redirect', function () { 
$query - http build query([ 
'client id' -» 'client-id', 
'redirect uri' => 'http://example.com/callback', 
'response type' => 'code', 
'scope! => '', 


1); 


return redirect('http://your-app.com/oauth/authorize?'.$quer 


y); 

3); 

Foy n ww 
存在 这 个 第 三 方 客户 端 ， 如 果 验 证 通过 ， 将 会 泻 染 出 我 们 的 授权 页 面 。 


public function forAuthorization() 
{ 


$this->router->group(['middleware' => ['web', 'auth']], func 
tion ($router) { 


$router->get('/authorize', [ 
‘uses! => 'AuthorizationControllerQauthorize', 


]); 


$router->post('/authorize', [ 
'uses' => 'ApproveAuthorizationController@approve', 


]); 


$router->delete('/authorize', [ 
'uses' => 'DenyAuthorizationControllerQdeny', 


]); 
}); 


public function authorize(ServerRequestInterface $psrRequest, 
Request $request, 
ClientRepository $clients, 
TokenRepository $tokens) 


return $this->withErrorHandling(function () use ($psrRequest 


647 


, $request, $clients, $tokens) { 


$authRequest = $this->server ->validateAuthorizationReque 
st($psrRequest); 


$scopes = $this-»parseScopes($authRequest); 


$token = $tokens->findValidToken( 
$user = $request->user(), 


$client = $clients->find($authRequest ->getClient() -> 
getIdentifier()) 


); 


if ($token && $token->scopes === collect($scopes) ->pluck( 
'id')->all()) { 


return $this->approveRequest($authRequest, $user); 


$request ->session()->put('authRequest', $authRequest); 


return $this->response->view('passport::authorize', [ 
'client' => $client, 
'user' => $user, 
'scopes' => $scopes, 
'request' => $request, 


这 里 最 关键 的 就 是 validateAuthorizationRequest 这 个 函数 : 


public function validateAuthorizationRequest(ServerRequestInterf 
ace $request) 


1 
foreach ($this->enabledGrantTypes as $grantType) { 


if ($grantType->canRespondToAuthorizationRequest ($reques 


t)) { 


return $grantType->validateAuthorizationRequest ($req 
uest); 


throw OAuthServerException: :unsupportedGrantType(); 


canRespondToAuthorizationRequest 用 于 验证 授权 模式 与 参数 的 
response type 是 否 符 合 。 如 果 确 认 授权 模式 正确 ， 那 么 接 下 来 就 会 继续 验证 以 
下 几 项 : 


e P 35 id 

e redirect 重 定向 地 址 
e scopes 授权 范 

e state 客户 端 状态 


~ 


BP 3 


public function validateAuthorizationRequest(ServerRequestInterf 
ace $request) 
{ 
$clientId = $this->getQueryStringParameter ( 
-Clemneni 
$request, 
$this->getServerParameter('PHP_AUTH_USER', $request) 
); 
if (is null($clientId)) { 
throw OAuthServerException::invalidRequest('client id'); 


} 
$client = $this->clientRepository->getClientEntity( 
$clientId, 
$this->getIdentifier(), 
null, 
false 
); 
if ($client instanceof ClientEntityInterface === false) ( 


$this->getEmitter()->emit(new RequestEvent(RequestEvent: 
:CLIENT_AUTHENTICATION_FAILED, $request) ); 
throw OAuthServerException::invalidClient(); 


} 
} 
public function getIdentifier() 
{ 

return 'authorization code'; 
} 


客户 端的 验证 主要 是 利用 请 求 中 的 参数 client id ， 我 们 会 从 表 
oauth clients 的 表 中 按照 client id 来 取出 数据 库 记 录 : 


public function getClientEntity($clientIdentifier, $grantType, 
$clientSecret = null, $mustV 
alidateSecret - true) 


$record = $this->clients->findActive($clientIdentifier); 

if (! $record || ! $this->handlesGrant($record, $grantType) ) 
return; 

$client = new Client( 
$clientIdentifier, $record->name, $record->redirect 

); 


if ($mustValidateSecret && 
! hash_equals($record->secret, (string) $clientSecret)) 


{ 
return; 

} 

return $client; 
} 
public function findActive($id) 
{ 

$client = $this->find($id); 

return $client && ! $client->revoked ? $client : null; 
n 


protected function handlesGrant($record, $grantType) 
{ 
switch ($grantType) { 
case 'authorization code': 
return ! $record-»firstParty(); 
case 'personal access': 
return $record-»personal access client; 
case 'password': 
return $record-»password client; 
default: 
return true; 


A oauth clients 中 还 有 两 个 字段 personal access ^ password ， 对 于 
授权 码 模式 来 说 这 两 个 字段 都 要 求 为 0。 


重 定 向 地 址 


public function validateAuthorizationRequest(ServerRequestInterf 


ace $request) 


i 


$redirectUri = $this->getQueryStringParameter('redirect_uri' 
, $request); 
if ($redirectUri !== null) ( 
on RN 
is string($client-»getRedirectUri()) 
&& (strcmp($client-»5getRedirectUri(), $redirectUri) 
I-- 0) 
) 
$this->getEmitter()->emit(new RequestEvent(RequestEv 
ent: :CLIENT AUTHENTICATION FAILED, $request)); 
throw OAuthServerException::invalidClient(); 
) elseif ( 
is array($client-»getRedirectUri()) 
&& in array($redirectUri, $client-»getRedirectUri()) 
=== false 
) í 
$this->getEmitter()->emit(new RequestEvent(RequestEv 
ent::CLIENT AUTHENTICATION FAILED, $request)); 
throw OAuthServerException::invalidClient(); 
} 
} elseif (is_array($client->getRedirectUri()) && count($clie 
nt->getRedirectUri()) !== 1 
|| empty($client->getRedirecturi()) 


Jot 


$this->getEmitter()->emit(new RequestEvent(RequestEvent: 


:CLIENT AUTHENTICATION FAILED, $request)); 
throw OAuthServerException::invalidClient(); 


这 部 分 验证 参数 中 的 redirect uri 是 否 与 数据 库 中 的 重 定向 地 址 是 否 一 致 。 


授权 作用 域 


授权 作用 域 可 以 让 API 客户 端 在 请 求 账户 授权 时 请 求 特定 的 权限 。 例 如 ， 如 果 你 正 
在 构建 电子 商务 应 用 程序 ， 并 不 是 所 有 接 入 的 API 应 用 都 需要 下 订单 的 功能 。 你 可 
以 让 接 入 的 APL 应 用 只 被 允许 授权 访问 订单 发 货 状态 。 换 多 话说 ， 作 用 域 允许 应 用 
程序 的 用 户 限制 第 三 方 应 用 程序 执行 的 操作 。 


你 可 以 在 AuthServiceProvider 的 boot 方法 中 使 用 Passport::tokensCan 方法 来 定 
SL API 的 作用 域 。tokensCan 方法 接受 一 个 作用 域名 称 、 描 述 的 数组 作为 参数 。 作 
用 域 描述 将 会 在 授权 确认 页 中 直接 展示 给 用 户 ， 你 可 以 将 其 定义 为 任何 你 需要 的 内 


Gy 。 


2: 


Passport: :tokensCan([ 
'place-orders' => 'Place orders', 
'check-status' => 'Check order status', 


1); 
public static function tokensCan(array $scopes) 
{ 
static::$scopes = $scopes; 
} 


验证 授权 作用 域 的 时 候 ， 只 是 在 Passport 中 验证 是 否 存 在 该 授权 作用 域 : 


public function validateAuthorizationRequest(ServerRequestInterf 
ace $request) 


( 


$scopes = $this->validateScopes( 
$this->getQueryStringParameter('scope', $request, $this- 
>defaultScope), 
is_array($client->getRedirectUri() ) 
? $client->getRedirectUri()[0] 
: $client->getRedirectUri() 


public function validateScopes($scopes, $redirectUri = null) 


Y 
$scopesList - array filter(explode(self::SCOPE DELIMITER STR 


ING, trim($scopes)), function ($scope) { 
return !empty($scope); 


3): 
$validScopes - []; 


foreach ($scopesList as $scopelItem) { 
$scope = $this-»scopeRepository-»getScopeEntityByIdentif 
ier($scopeItem); 


if ($scope instanceof ScopeEntityInterface === false) ( 
throw OAuthServerException::invalidScope($scopeItem, 
$redirectUri); 


j 


$validScopes[] - $scope; 


return $validScopes; 


public function getScopeEntityByIdentifier($identifier) 


{ 
if (Passport::hasScope($identifier)) { 
return new Scope($identifier ); 


state 


这 个 字段 用 于 防止 csf 攻击 的 ， 具 体 可 以 查看 : 移花接木 : 针对 OAuth2 的 CSRF 
攻击 


public function validateAuthorizationRequest(ServerRequestInterf 
ace $request) 
{ 

$stateParameter = $this->getQueryStringParameter('state', $r 
equest); 


$authorizationRequest = new AuthorizationRequest(); 
$authorizationRequest-»setGrantTypeld($this-»getIdentifi 


er()); 
$authorizationRequest-»setClient($client); 
$authorizationRequest-»setRedirectUri($redirectUri); 
$authorizationRequest-»setState($stateParameter); 
$authorizationRequest-»setScopes($scopes); 

} 


验证 结束 后 ， 接 下 来 就 会 验证 当前 用 户 是 否 已 经 授权 过 ， 如 果 已 经 授权 过 ， 那 么 就 
会 直接 返回 授权 码 ， 否 则 就 会 泻 染 授权 页 面 : 


public function authorize(ServerRequestiInterface $psrRequest, 
Request $request, 
ClientRepository $clients, 
TokenRepository $tokens) 


return $this->withErrorHandling(function () use ($psrRequest 
, $request, $clients, $tokens) { 
$authRequest = $this->server->validateAuthorizationReque 
st($psrRequest); 


$scopes = $this-»parseScopes($authRequest); 


$token = $tokens->findValidToken( 
$user = $request->user(), 
$client = $clients->find($authRequest ->getClient() -> 
getIdentifier()) 
); 


if ($token && $token->scopes === collect($scopes)-»pluck( 
'id')->all()) { 
return $this->approveRequest($authRequest, $user); 


$request ->session()->put('authRequest', $authRequest); 


return $this->response->view('passport::authorize', [ 
'client' => $client, 
'user' => $user, 
'scopes' => $scopes, 
'request' => $request, 

1); 

+); 
} 


LT ccs] X] 
验证 用 户 的 是 否 授权 首先 是 查看 授权 作用 域 是 否 与 数据 库 保 持 一 致 。 由 于 授权 作用 


域 与 token 相互 关联 ， 并 非 与 客户 端 相互 关联 ， 所 以 scopes 没有 在 
oauth clients 表 中 ， 而 是 在 oauth access tokens 这 个 表 中 。 


protected function parseScopes($authRequest ) 


{ 
return Passport: :scopesFor ( 
collect ($authRequest ->getScopes())->map(function ($scope) 
x 
return $scope-»getIdentifier(); 
3)-2all() 
); 
} 


public static function scopesFor(array $ids) 


{ 
return collect($ids)->map(function ($id) { 
if (isset(static::$scopes[$id])) { 
return new Scope($id, static::$scopes[$id]); 
} 
return; 
})->filter()->values()->all(); 
} 


El E uj 
可 以 看 到 ， 作 用 域 的 identifier 就 是 Scope 的 id ° 
获取 已 授权 token 


token 的 获取 主要 是 利用 client id 与 user id 在 表 
oauth_access_tokens 中 查询 符合 条 件 的 token 。 


public function findValidToken($user, $client) 


{ 
return $client->tokens() 
-»whereUserId(S$user-»getKey()) 
->whereRevoked (0) 
->where('expires_at', '>', Carbon: :now()) 
->latest('expires_at') 
->first(); 
} 
public function tokens() 
{ 
return $this->hasMany(Token::class, 'client id'); 
} 


在 获取 到 有 效 的 token 之 后 ， 并 且 token 的 作用 域 符合 请 求 参 数 ， 就 会 立即 
返回 ， 不 需要 用 户 的 重复 授权 : 


protected function approveRequest($authRequest, $user) 


i 


$authRequest ->setUser(new User($user->getKey())); 
$authRequest-»setAuthorizationApproved(true); 
return $this->convertResponse( 


$this-»server-»completeAuthorizationRequest($authRequest 
, new Psr7Response) 


); 


授权 成 功 


用 户 点 击 确认 按钮 ， 授 权 成 功 之 后 ， 服 务 器 就 会 跳 转 到 客户 端 预 设 的 
redirecturi ， 并 且 携带 授权 码 等 一 系列 参数 


$router->post('/authorize', [ 
'uses' => 'ApproveAuthorizationControllerQapprove', 


]); 


public function approve(Request $request) 
{ 
return $this->withErrorHandling(function () use ($request) { 
$authRequest = $this->getAuthRequestFromSession($request 
); 


return $this->convertResponse( 
$this->server->completeAuthorizationRequest($authReq 
uest, new Psr7Response) 
); 
}); 


completeAuthorizationRequest 是 授权 服务 器 的 重要 步骤 : 


public function completeAuthorizationRequest(AuthorizationReques 
t $authRequest, ResponseInterface $response) 


1 
return $this->enabledGrantTypes[$authRequest ->getGrantTypeld 
()] 
-»completeAuthorizationRequest($authRequest) 
-»generateHttpResponse($response); 
} 


public function completeAuthorizationRequest(AuthorizationReques 
t $authorizationRequest ) 
{ 
if ($authorizationRequest->getUser() instanceof UserEntityIn 
terface === false) { 
throw new \LogicException('An instance of UserEntityInte 
rface should be set on the AuthorizationRequest'); 


j 


$finalRedirectUri = ($authorizationRequest-»getRedirectUri() 


=== null) 


? is_array($authorizationRequest ->getClient()->getRedire 


ctUri()) 


? $authorizationRequest->getClient()->getRedirectUri 


() [9] 


$authorizationRequest ->getClient()->getRedirectUri 


() 


$authorizationRequest-»getRedirectUri(); 


/ 


auth code 


// The user approved the client, re 


direct them back with an 


if ($authorizationRequest ->isAuthorizationApproved() === true 


)i 


$authCode = $this->issueAuthCode( 


$this->authCodeTTL, 


$authorizationRequest ->getClient(), 


$authorizationRequest ->getUser()->getIdentifier(), 


$authorizationRequest-»getRedirectUri(), 


$authorizationRequest-»getScopes() 


); 
$payload - [ 
relient id => 
etIdentifier(), 
'redirect uri' => 
(), 
'auth code id' => 
), 
'scopes' => 
'user_id' => 
ier(), 
'expire time' => 
his->authCodeTTL)->format('U'), 
'code challenge' 5> 
tCodeChallenge(), 


'code challenge method' => 
tCodeChallengeMethod(), 


]; 


$authCode->getClient()->g 


$authCode->getRedirectUri 


$authCode->getIidentifier ( 


$authCode->getScopes(), 
$authCode-»getUserIdentif 


(new \DateTime())->add($t 


$authorizationRequest-»ge 


$authorizationRequest-»ge 


$response = new RedirectResponse(); 
$response-»setRedirectUri( 
$this-»makeRedirectUri( 


$finalRedirectUri, 
[ 
'code' => $this->encrypt ( 
json_encode( 
$payload 
) 


); 


'state' => $authorizationRequest-»getState() 


): 


return $response; 


// The user denied the client, redirect them back with an er 


ror 
throw OAuthServerException: :accessDenied( 
'The user denied the request', 
$this->makeRedirectUri( 
$finalRedirectUri, 
[ 
'state' => $authorizationRequest ->getState(), 
] 
) 
); 
} 


4 aay 


这 里 最 重要 的 就 是 issueAuthCode 生成 授权 码 : 


protected function issueAuthCode( 

NDatelnterval $authCodeTTL, 

ClientEntityInterface $client, 

$userIdentifier, 

$redirectUri, 

array $scopes - [] 
ET 

$maxGenerationAttempts = self::MAX RANDOM TOKEN GENERATION A 
TTEMPTS; 


$authCode = $this-»-authCodeRepository-»getNewAuthCode( ); 

$authCode-»setExpiryDateTime((new \DateTime() )->add($authCod 
eTTL)); 

$authCode->setClient($client); 

$authCode->setUserIdentifier ($userIdentifier); 

$authCode->setRedirectUri($redirecturi); 


foreach ($scopes as $scope) { 
$authCode-»addScope($scope); 


while ($maxGenerationAttempts-- > 0) { 
$authCode->setIidentifier ($this->generateUniqueldentifier 
()); 


ery et 
$this ->authCodeRepository->persistNewAuthCode($authC 


ode); 


return $authCode; 
} catch (UniqueTokenIdentifierConstraintViolationExcepti 
on $e) { 
if ($maxGenerationAttempts === 0) { 
throw $e; 


其 中 generateUniquelIdentifier 就 是 生成 授权 码 的 步骤 ， 这 个 授权 码 也 是 表 
oauth_auth_codes 的 id 


protected function generateUniquelIdentifier($length = 40) 


{ 
try i 
return bin2hex(random_bytes($length) ); 
// QcodeCoverageIgnoreStart 
) catch (NTypeError $e) { 
throw OAuthServerException::serverError('An unexpected e 
rror has occurred ); 
) catch (NError $e) ( 
throw OAuthServerException::serverError('An unexpected e 
rror has occurred ' ); 
) catch (NException $e) { 
// If you get this message, the CSPRNG failed hard. 
throw OAuthServerException::serverError('Could not gener 
ate a random string'); 


j 


// QcodeCoverageIgnoreEnd 


public function persistNewAuthCode(AuthCodeEntityInterface $auth 
CodeEntity) 
{ 
$this->database->table('oauth_auth_codes' )->insert([ 
'id' => $authCodeEntity->getIdentifier(), 
'user id' => $authCodeEntity->getUserIdentifier(), 
'client id' => $authCodeEntity->getClient()->getIdentifi 
er(), 
‘scopes! => $this->formatScopesForStorage($authCodeEntit 
y->getScopes()), 
'revoked' => false, 
'expires at' => $authCodeEntity->getExpiryDateTime(), 
1); 


授权 码 转 为 令 牌 


由 于 client id ZAAM> AtL-VREBHRRMOLRAZ? AEE 
AY x J& AR AG $6 A 4: 


Route: :get('/callback', function (Request $request) { 
$http = new GuzzleHttp\Client; 


$response = $http-»post('http://your-app.com/oauth/token', [ 
'form params' => [ 
'grant type' => 'authorization_code', 
'client id' => 'client-id', 
'client secret' => 'client-secret', 
'redirect uri' => 'http://example.com/callback', 
'code' => $request->code, 
], 
1); 


return json decode((string) $response->getBody(), true); 


3); 


这 一 步 需要 客户 端 提供 注册 时 返回 的 密码 ， 


public function forAccessTokens() 


{ 
$this->router->post('/token', [ 
'uses' => 'AccessTokenControllerQissueToken', 
'middleware' => 'throttle', 
1); 
} 


public function issueToken(ServerRequestInterface $request) 
{ 
return $this->withErrorHandling(function () use ($request) { 
return $this->convertResponse( 
$this->server ->respondToAccessTokenRequest ($request, 
new Psr7Response) 
); 
3); 


这 一 步 需 要 验证 的 东西 非常 繁多 ， 我 们 分 部 分 来 看 : 


客户 端 验证 主要 校 验 client id ^ client secret ^ redirect uri 


public function respondToAccessTokenRequest( 
ServerRequestInterface $request, 
ResponseTypelInterface $responseType, 
NDateInterval $accessTokenTTL 


) { 
$client = $this->validateClient($request); 
} 
protected function validateClient(ServerRequestInterface $reques 
t) 
{ 


list($basicAuthUser, $basicAuthPassword) = $this->getBasicAu 
thCredentials($request); 


$clientId = $this->getRequestParameter('client_id', $request 
, $basicAuthUser); 


// If the client is confidential require the client secret 
$clientSecret = $this->getRequestParameter('client_secret', 
$request, $basicAuthPassword); 


$client = $this-»clientRepository-»getClientEntity( 
$clientId, 
$this->getIdentifier(), 
$clientSecret, 
true 


); 


$redirectUri = $this->getRequestParameter('redirect_uri', $r 
equest, null); 


return $client; 


protected function getBasicAuthCredentials(ServerRequestinter fac 
e $request) 
{ 
if (!$request->hasHeader('Authorization')) { 
return [null null}; 


$header = $request->getHeader('Authorization')[0]; 
if (strpos($header, 'Basic ') !== 0) ( 
return [null, null); 


if (!($decoded = base64_decode(substr($header, 6)))) { 
return [null, null]; 


if (strpos($decoded, ':') === false) { 
return [null, null]; // HTTP Basic header without colon 
isn't valid 


} 
return explode(':', $decoded, 2); 
} 
Je TE 4 AL AG 


客户 端的 密码 验证 通过 后 ， 就 会 开始 验证 授权 码 ， 授 权 码 的 验证 主要 涉及 


expire time ^ client id ^ auth code id: 


public function respondToAccessTokenRequest ( 
ServerRequestInterface $request, 
ResponseTypelInterface $responseType, 
\DateInterval $accessTokenTTL 


JEU 


$encryptedAuthCode = $this->getRequestParameter('code', $req 
uest, null); 


if ($encryptedAuthCode === null) { 

throw OAuthServerException: :invalidRequest('code'); 
} 
try { 


$authCodePayload = json_decode($this->decrypt($encrypted 
AuthCode) ); 
if (time() > $authCodePayload->expire_time) { 
throw OAuthServerException::invalidRequest('code', ' 
Authorization code has expired'); 


} 


if ($this->authCodeRepository->isAuthCodeRevoked($authCo 
dePayload->auth_code_id) === true) { 
throw OAuthServerException::invalidRequest('code', ' 
Authorization code has been revoked'); 


j 


if ($authCodePayload-»client id !== $client->getIdentifi 
er()) { 
throw OAuthServerException::invalidRequest('code', ' 
Authorization code was not issued to this client'); 


j 


// *he redirect URI is required in this request 
$redirectUri = $this-»getRequestParameter('redirect uri' 
, $request, null); 
if (empty($authCodePayload-»redirect uri) === false && $ 
redirectUri --- null) ( 
throw OAuthServerException::invalidRequest('redirect 
ZU 


if ($authCodePayload-»redirect uri !-- $redirectUri) ( 
throw OAuthServerException: :invalidRequest('redirect 


_uri', “Invalid redirect URI”); 


j 


) catch (NLogicException $e) { 
throw OAuthServerException::invalidRequest('code', 'Cann 
ot decrypt the authorization code'); 


} 
} 
public function isAuthCodeRevoked($codelId) 
{ 
return $this->database->table('oauth_auth_codes' ) 
-»where('id', $codeId)->where('revoked', 1)->exi 
sts(); 
} 
发 放 令 牌 


令 牌 的 发 放 主要 是 access token ^ refresh token ， 并 且 取 消 相 关 的 授权 
A: 


public function respondToAccessTokenRequest( 
ServerRequestInterface $request, 
ResponseTypelInterface $responseType, 
NDateInterval $accessTokenTTL 


Jot 


// Issue and persist access + refresh tokens 

$accessToken = $this->issueAccessToken($accessTokenTTL, $cli 
ent, $authCodePayload->user_id, $scopes); 

$refreshToken = $this->issueRefreshToken($accessToken) ; 


// Inject tokens into response type 
$responseType ->setAccessToken($accessToken) ; 
$responseType->setRefreshToken($refreshToken) ; 


// Revoke used auth code 
$this->authCodeRepository->revokeAuthCode($authCodePayload-> 
auth_code_id); 


return $responseType; 


首先 需要 生成 access token ， 之 后 再 对 表 oauth access tokens 持久 化 
access token 


protected function issueAccessToken( 

NDatelnterval $accessTokenTTL, 

ClientEntityInterface $client, 

$userIdentifier, 

array $scopes - [] 
Ja 

$maxGenerationAttempts = self::MAX RANDOM TOKEN GENERATION A 
TTEMPTS; 


$accessToken = $this->accessTokenRepository->getNewToken($cl 
ient, $scopes, $userIdentifier); 
$accessToken-»setClient($client); 
$accessToken->setUserIdentifier($userIdentifier ); 
$accessToken->setExpiryDateTime( (new \DateTime())->add($acce 


ssTokenTTL)); 


foreach ($scopes as $scope) ( 
$accessToken-»addScope($scope); 


while ($maxGenerationAttempts-- > 0) { 
$g$accessToken->setIdentifier ($this->generateUniqueldentif 
ier()); 
try q 
$this->accessTokenRepository->persistNewAccessToken( 
$accessToken); 


return $accessToken; 
} catch (UniqueTokenlIdentifierConstraintViolationExcepti 
on $e) { 
if ($maxGenerationAttempts === 0) ( 
throw $e; 


public function getNewToken(ClientEntityInterface $clientEntity, 
array $scopes, $userIdentifier - null) 


( 


return new AccessToken($userIdentifier, $scopes); 


protected function generateUniqueldentifier($length 


( 


40) 


Dn 
return bin2hex(random_bytes($length) ); 


// QcodeCoverageIgnoreStart 
} catch (\TypeError $e) { 
throw OAuthServerException::serverError('An unexpected e 
rror has occurred! ); 
) catch (NError $e) ( 
throw OAuthServerException::serverError('An unexpected e 
rror has occurred ); 


} catch (\Exception $e) { 
// If you get this message, the CSPRNG failed hard. 
throw OAuthServerException::serverError('Could not gener 
ate a random string'); 


j 


// QcodeCoverageIgnoreEnd 


public function persistNewAccessToken(AccessTokenEntityInterface 
$accessTokenEntity) 
1 
$this->tokenRepository->create([ 
'id' => $accessTokenEntity->getIdentifier(), 
'user id' => $accessTokenEntity->getUserIdentifier(), 
'client id' => $accessTokenEntity->getClient()->getIdent 
ifier(), 
‘scopes! => $this->scopesToArray($accessTokenEntity->get 
Scopes()), 
'revoked' => false, 
'created at' => new DateTime, 
'updated at' -» new DateTime, 
'expires at' => $accessTokenEntity->getExpiryDateTime(), 


1); 


$this->events->dispatch(new AccessTokenCreated( 
$accessTokenEntity-»getIdentifier(), 
$accessTokenEntity->getUserIdentifier(), 
$accessTokenEntity->getClient()->getIdentifier() 


2); 


类 似 地 ， 还 有 生成 refresh token 


protected function issueRefreshToken(AccessTokenEntityInterface 
$accessToken) 
{ 

$maxGenerationAttempts = self::MAX RANDOM TOKEN GENERATION A 
TTEMPTS; 


$refreshToken = $this-»refreshTokenRepository-»getNewRefresh 
Token(); 

$refreshToken->setExpiryDateTime( (new \DateTime())->add($thi 
s->refreshTokenTTL) ); 

$refreshToken->setAccessToken($accessToken) ; 


while ($maxGenerationAttempts-- > 0) { 
$refreshToken->setIdentifier ($this->generateUniquelIdenti 
fier()); 
try v 
$this->refreshTokenRepository->persistNewRefreshToke 
n($refreshToken); 


return $refreshToken; 
) catch (UniqueTokenIdentifierConstraintViolationExcepti 
on $e) { 


if ($maxGenerationAttempts === 0) { 
throw $e; 
} 
} 
} 
} 
BearerToken 


为 了 加 强 安全 性 ， 根 据 OAuth2 规范 ，access token 5 refresh token 需 
要 利用 Bearer Token 的 方式 给 出 ， access token 会 被 转化 为 


JWT ， refresh token 会 被 加 密 : 


public function generateHttpResponse(ResponseInterface $response) 


$expireDateTime = $this->accessToken->getExpiryDateTime( )->g 
etTimestamp(); 


$jwtAccessToken = $this->accessToken->convertToJwT($this->pr 
ivateKey); 


$responseParams - [ 
'token type' -» 'Bearer', 
'expires in' => $expireDateTime - (new \DateTime())->g 


etTimestamp(), 
'access token' => (string) $jwtAccessToken, 


1; 


if ($this->refreshToken instanceof RefreshTokenEntityInterfa 
ce) { 
$refreshToken = $this->encrypt( 
json_encode( 
[ 

"elxent-rd' => $this->accessToken->ge 
tClient()->getIdentifier(), 

'refresh token id' => $this->refreshToken->g 
etIdentifier(), 


"access token id' => $this->accessToken->ge 
tIdentifier(), 

'scopes' => $this->accessToken->ge 
tScopes(), 

'user id' => $this->accessToken->ge 
tUserIdentifier(), 

'expire time' => $this->refreshToken->g 


etExpiryDateTime()->getTimestamp(), 
] 


): 


$responseParams['refresh token'] = $refreshToken; 


$responseParams = array merge($this-»getExtraParams($this-»a 
ccessToken), $responseParams); 


$response = $response 
->withStatus( 200) 
->withHeader('pragma', 'no-cache' ) 
->withHeader('cache-control', 'no-store') 
->withHeader('content-type', 'application/json; charset- 
UTF-8'); 


$response-»getBody()-»write(json encode($responseParams)); 


return $response; 
n m——————————————————————— AQ eJ 


刷新 令 牌 


如 果 你 的 应 用 程序 发 放 了 短期 的 访问 令 牌 ， 用 户 将 需要 通过 在 发 出 访问 令 牌 时 提供 
给 他 们 的 刷新 令 牌 来 刷新 其 访问 令 牌 。 该 申请 的 url 与 申请 令 牌 的 链接 相同 ， 仅 
仅 grant_type 不 同 : 


$response = $http-»post('http://your-app.com/oauth/token', [ 
'form params' => [ 
'grant type' => 'refresh token', 
'refresh token' => 'the-refresh-token', 
'client id' => 'client-id', 
'client secret' => 'client-secret', 
'scope! => '', 
] 
1); 


return json decode((string) $response->getBody(), true); 


public function respondToAccessTokenRequest( 
ServerRequestInterface $request, 
ResponseTypelInterface $responseType, 
\DateInterval $accessTokenTTL 

) q 
// Validate request 
$client = $this->validateClient($request); 


$oldRefreshToken = $this->validateOldRefreshToken($request, 
$client->getIdentifier()); 
$scopes = $this->validateScopes($this->getRequestParameter ( 
'scope', 
$request, 
implode(self::SCOPE DELIMITER STRING, $oldRefreshToken|[ ' 
scopes'])) 


); 


// The OAuth spec says that a refreshed access token can hav 
e the original scopes or fewer so ensure 
// the request doesn't include any new scopes 
foreach ($scopes as $scope) { 
if (in_array($scope->getIdentifier(), $oldRefreshToken[' 
scopes']) --- false) ( 
throw OAuthServerException: :invalidScope($scope->get 
Identifier()); 


j 


// Expire old tokens 

$this->accessTokenRepository->revokeAccessToken($oldRefreshT 
oken['access token id']); 

$this->refreshTokenRepository->revokeRefreshToken($oldRefres 
hToken['refresh token id']); 


// Issue and persist new tokens 

$accessToken = $this->issueAccessToken($accessTokenTTL, $cli 
ent, $oldRefreshToken['user id'], $scopes); 

$refreshToken = $this->issueRefreshToken($accessToken) ; 


// Inject tokens into response 
$responseType ->setAccessToken($accessToken) ; 


$responseType-»setRefreshToken($refreshToken); 


return $responseType; 


Laravel Passport——OAuth2 API 认证 系统 源码 解析 
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Laravel Passport——OdAuth2 API 认证 系统 
源码 解析 (下 ) 


隐 式 授权 
隐 式 授权 类 似 于 授权 码 授权 ， 但 是 它 只 令 牌 将 返回 给 客户 端 而 不 交换 授权 码 。 这 种 


授权 最 常用 于 无 法 安全 存储 客户 端 凭据 的 JavaScript 或 移动 应 用 程序 。 通 过 调用 
AuthServiceProvider 中 的 enableImplicitGrant 方法 来 启用 这 种 授权 : 


public function boot() 


{ 
$this->registerPolicies(); 
Passport: :routes(); 
Passport: :enableImplicitGrant(); 
} 


调用 上 面 方法 开启 授权 后 ， 开 发 者 可 以 使 用 他 们 的 客户 端 ID 从 应 用 程序 请 求 访问 
令 牌 。 接 入 的 应 用 程序 应 该 向 你 的 应 用 程序 的 Joauth/authorize 路 由 发 出 重 定向 请 
求 ， 如 下 所 示 : 


Route::get('/redirect', function () { 
$query = http_build_query([ 
'client id' => 'client-id', 
'redirect uri' => 'http://example.com/callback', 
'response type' => 'token', 
'Scope' => '', 


]); 


return redirect('http://your-app.com/oauth/authorize?'.$quer 


y); 
3): 


首先 仍然 是 验证 授权 请 求 的 合法 性 ， 其 流程 与 授权 码 模 式 基 本 一 致 : 


public function validateAuthorizationRequest(ServerRequestInterf 
ace $request) 
{ 
$clientId = $this->getQueryStringParameter ( 
-Clemneni 
$request, 
$this->getServerParameter('PHP_AUTH_USER', $request) 
); 
if (is null($clientIid)) { 
throw OAuthServerException::invalidRequest('client id'); 


} 
$client = $this-»clientRepository-»getClientEntity( 
$clientId, 
$this->getIdentifier(), 
null, 
false 
); 
if ($client instanceof ClientEntityInterface === false) ( 


$this->getEmitter()->emit(new RequestEvent(RequestEvent: 
:CLIENT_AUTHENTICATION_FAILED, $request) ); 
throw OAuthServerException::invalidClient(); 


$redirectUri = $this-»getQueryStringParameter('redirect uri' 
, $request); 


$scopes = $this->validateScopes( 
$this->getQueryStringParameter('scope', $request, $this- 
>defaultScope), 
is array($client-»getRedirectUri()) 
? $client->getRedirectUri()[0] 
$client ->getRedirecturi( ) 
); 


// Finalize the requested scopes 
$finalizedScopes = $this->scopeRepository ->finalizeScopes ( 
$scopes, 


$this->getIdentifier(), 
$client 


): 


$stateParameter = $this->getQueryStringParameter('state', $r 
equest); 


$authorizationRequest = new AuthorizationRequest(); 
$authorizationRequest-»setGrantTypeld($this-»getIdentifier() 


$authorizationRequest-»setClient($client); 
$authorizationRequest-»setRedirectUri($redirectUri); 
$authorizationRequest ->setState($stateParameter ); 
$authorizationRequest ->setScopes($finalizedScopes) ; 


return $authorizationRequest; 


接着 ， 当 用 户 同 意 授权 之 后 ， 就 要 直接 返回 access token * League OAuth2 
直接 将 令 牌 放 入 JWT 中 发 送 回 第 三 方 客户 端 ,值得 注意 的 是 依据 OAuth2 标准 ， 
参数 都 是 以 location hash 的 形式 返回 的 ， 间 隔 符 是 # ， 而 不 是 7: 


public function __construct(\DateInterval $accessTokenTTL, $quer 
yDelimiter = '#') 
{ 


$this->accessTokenTTL 
$this->queryDelimiter = $queryDelimiter; 


$accessTokenTTL; 


public function completeAuthorizationRequest(AuthorizationReques 
t $authorizationRequest) 
{ 
if ($authorizationRequest->getUser() instanceof UserEntityIn 
terface === false) { 
throw new NLogicException('An instance of UserEntityInte 
rface should be set on the AuthorizationRequest' ); 


j 


$finalRedirectUri = ($authorizationRequest-»getRedirectUri() 


=== null) 
? is_array($authorizationRequest ->getClient()->getRedire 
ctUri()) 


? $authorizationRequest->getClient()->getRedirectUri 


()[9] 
$authorizationRequest ->getClient()->getRedirectUri 
() 
$authorizationRequest-»getRedirectUri(); 

// The user approved the client, redirect them back with an 
access token 

if ($authorizationRequest-»isAuthorizationApproved() === true 
) { 


$accessToken = $this->issueAccessToken( 
$this->accessTokenTTL, 
$authorizationRequest ->getClient(), 
$authorizationRequest ->getUser()->getIdentifier(), 
$authorizationRequest ->getScopes( ) 


); 


$response = new RedirectResponse(); 
$response->setRedirectUri( 
$this->makeRedirectUri( 
$finalRedirectUri, 
[ 


'access_token' => (string) $accessToken->con 
vertToJWT($this-»privateKey), 


'token type' -» 'Bearer', 
'expires in' => $accessToken-»getExpiryDat 
eTime()->getTimestamp() - (new \DateTime())->getTimestamp(), 
'state' => $authorizationRequest ->get 
State(), 
], 
$this->queryDelimiter 
) 
); 


return $response; 


// The user denied the client, redirect them back with an er 
ror 
throw OAuthServerException: :accessDenied( 
"The user denied the request", 
$this-»makeRedirectUri( 
$finalRedirectUri, 


[ 


'state' => $authorizationRequest ->getState(), 


这 个 用 于 构建 jwt 的 私 钥 就 是 oauth-private.key ， 我 们 知道 ， jwt 一 般 
有 三 个 部 分 组 成 : header ^ claim ^ sign ,用 于 oauth2 的 jwt 中 
claim 主要 构成 有 : 


e aud ŽP a id 

e jtiaccess token 随机 码 

e iat 生成 时 间 

e nbf 拒绝 接受 jwt 时 间 

e exp access_token 失效 时 间 
e sub 用 户 id 


具体 可 以 参考 : JSON Web Token (JWT) draft-ietf-oauth-json-web-token-32 


public function convertToJWT(CryptKey $privateKey ) 


{ 
return (new Builder()) 

->setAudience($this->getClient()->getIdentifier() ) 
->setId($this->getIdentifier(), true) 
-»setIssuedAt(time()) 
-»setNotBefore(time()) 
->setExpiration($this->getExpiryDateTime( )->getTimestamp 

()) 


->setSubject($this->getUserIdentifier() ) 
-»set('scopes', $this->getScopes()) 
->sign(new Sha256(), new Key($privateKey->getKeyPath(), 


$privateKey-»getPassPhrase())) 
->getToken(); 


pubixc Tunet ion S2consteruct( 
Encoder $encoder = null, 
ClaimFactory $claimFactory = null 

JS 
$this->encoder = $encoder ?: new Encoder(); 
$this->claimFactory = $claimFactory ?: new ClaimFactory(); 
$this->headers = ['typ'=> 'JWT', 'alg' => 'none']; 
$this->claims = []; 


public function setAudience($audience, $replicateAsHeader = fals 
e) 
{ 

return $this->setRegisteredClaim('aud', (string) $audience, 
$replicateAsHeader); 


j 


public function setId($id, $replicateAsHeader = false) 
{ 

return $this->setRegisteredClaim('jti', (string) $id, $repli 
cateAsHeader); 


} 


public function setIssuedAt($issuedAt, $replicateAsHeader = fals 
e) 
{ 

return $this->setRegisteredClaim('iat', (int) $issuedAt, $re 
plicateAsHeader); 


j 


public function setNotBefore($notBefore, $replicateAsHeader = fa 
lse) 
{ 

return $this->setRegisteredClaim('nbf', (int) $notBefore, $r 
eplicateAsHeader ) ; 


} 


public function setExpiration($expiration, $replicateAsHeader = 
false) 
{ 

return $this->setRegisteredClaim('exp', (int) $expiration, $ 
replicateAsHeader ) ; 


} 


public function setSubject($subject, $replicateAsHeader = false) 
{ 

return $this-»setRegisteredClaim('sub', (string) $subject, $ 
replicateAsHeader); 


} 
public function sign(Signer $signer, $key) 
{ 
$signer ->modifyHeader ($this->headers) ; 
$this->signature = $signer ->sign( 
$this->getToken()->getPayload(), 
$key 
); 
return $this; 
} 


public function getToken() 
{ 
$payload = [ 
$this->encoder ->base64UrlEncode($this->encoder->jsonEnco 
de($this->headers)), 
$this->encoder ->base64UrlEncode($this->encoder->jsonEnco 
de($this->claims)) 
]; 


if ($this->signature !== null) { 
$payload[] = $this->encoder->base64UrlEncode($this->sign 
ature); 


} 


return new Token($this->headers, $this->claims, $this->signa 
ture, $payload); 
} 


根据 JWT 的 生成 方法 ， 签 名 部 分 signature 是 header 4 claim 进行 
base64 编码 后 再 加 密 的 结果 。 


户 端 模式 


客户 端 凭据 授权 适用 于 机 器 到 机 器 的 认证 。 例 如 ， 你 可 以 在 通过 API 执行 维护 任务 
中 使 用 此 授权 。 要 使 用 这 种 授权 ， 你 首先 需要 在 app/Http/Kernel.php 的 
routeMiddleware 变量 中 添加 新 的 中 间 件 : 


protected $routeMiddleware = [ 
'client' => CheckClientCredentials::class, 


l; 
Route::get('/user', function(Request $request) { 


})->middleware('client'); 


接 下 来 通过 向 oauth/token 接口 发 出 请 求 来 获取 令 牌 : 


$response = $guzzle->post('http://your-app.com/oauth/token', [ 
'form params' => [ 
'grant type' => 'client_credentials', 
'client id' => 'client-id', 
'client secret' => 'client-secret', 
'scope' => 'your-scope', 
], 
1); 


echo json decode((string) $response->getBody(), true); 


客户 端 模式 类 似 于 授权 码 模 式 的 后 一 部 分 ， 利 用 客户 端 id 与 客户 端 密码 来 获取 


access_token 


public function respondToAccessTokenRequest( 
ServerRequestInterface $request, 
ResponseTypelInterface $responseType, 
NDateInterval $accessTokenTTL 

) i 
// Nalidate request 
$client = $this->validateClient($request) ; 


$scopes = $this->validateScopes($this->getRequestParameter ( ' 


scope', $request, $this->defaultScope) ); 


// Finalize the requested scopes 


$finalizedScopes = $this->scopeRepository->finalizeScopes($s 


copes, $this->getIdentifier(), $client); 


// Issue and persist access token 


$accessToken = $this->issueAccessToken($accessTokenTIL, $cli 


ent, null, $finalizedScopes); 


// Inject access token into response type 
$responseType ->setAccessToken($accessToken) ; 


return $responseType; 


类 似 于 授权 码 模 式 ， access token 的 发 放 也 是 通过 Bearer Token 中 存放 


JWT。 
ZE AD 1 AN, 


OAuth2 密码 授权 机 制 可 以 让 你 自己 的 客户 端 ( 如 移动 应 用 程序 ) 邮箱 地 址 或 者 用 
户 名 和 密码 获取 访问 令 牌 。 如 此 一 来 你 就 可 以 安全 地 向 自己 的 客户 端 发 出 访问 令 


牌 ， 而 不 需要 遍历 整个 OAuth2 授权 代码 重 定向 流程 。 


创建 密码 授权 的 客户 端 后 ， 就 可 以 通过 向 用 户 的 电子 邮件 地 址 和 密码 向 
loauth/token 路 由 发 出 POST 请 求 来 获取 访问 令 牌 。 而 该 路 由 已 经 由 


Passport::routes 方法 注册 ， 因 此 不 需要 手动 定义 它 。 如 果 请 求 成 功 ， 会 在 服务 端 


返回 的 JSON 响应 中 收 到 一 个 access token 和 refresh token : 


$response = $http-»post('http://your-app.com/oauth/token', [ 
'form params' => [ 
'grant type' => 'password', 
'client id' => 'client-id', 
'client secret' => 'client-secret', 
'username' => 'taylor@laravel.com', 
'password' => 'my-password', 
'scope! => '', 
], 
1); 


return json decode((string) $response->getBody(), true); 


只 要 用 用 户 名 与 密码 来 验证 合法 性 就 可 以 发 放 access token 5 
refresh_token 


public function respondToAccessTokenRequest ( 
ServerRequestInterface $request, 
ResponseTypeInterface $responseType, 
\DateInterval $accessTokenTTL 
Jat 
// Nalidate request 
$client = $this-»validateClient($request); 
$scopes = $this->validateScopes($this->getRequestParameter ( ' 
scope', $request, $this->defaultScope) ); 
$user = $this->validateUser($request, $client); 


// Finalize the requested scopes 
$finalizedScopes = $this->scopeRepository->finalizeScopes($s 
copes, $this->getIdentifier(), $client, $user->getIdentifier()); 


// Issue and persist new tokens 

$accessToken = $this->issueAccessToken($accessTokenTTL, $cli 
ent, $user->getIdentifier(), $finalizedScopes) ; 

$refreshToken = $this->issueRefreshToken($accessToken) ; 


// Inject tokens into response 
$responseType ->setAccessToken($accessToken) ; 
$responseType->setRefreshToken($refreshToken) ; 


return $responseType; 


protected function validateUser(ServerRequestInterface $request, 
ClientEntityInterface $client) 


{ 
$username = $this->getRequestParameter('username', $request) 
/ 
if (is_null($username)) { 
throw OAuthServerException: :invalidRequest('username' ); 
J 
$password = $this->getRequestParameter('password', $request) 
/ 
if (is_null($password)) { 
throw OAuthServerException: :invalidRequest('password'); 
} 
$user = $this->userRepository->getUserEntityByUserCredential 
si 
$username, 
$password, 
$this->getIdentifier(), 
$client 
); 
if ($user instanceof UserEntityInterface === false) { 


$this->getEmitter()->emit(new RequestEvent(RequestEvent: 
:USER_AUTHENTICATION_FAILED, $request) ); 


throw OAuthServerException::invalidCredentials(); 


return $user; 


路 由 保护 


Passport 包含 一 个 验证 保护 机 制 可 以 验证 请 求 中 传 入 的 访问 令 牌 。 配 置 api 的 看 
守 器 使 用 passport 驱动 程序 后 ， 只 需要 在 需要 有 效 访 问 令 牌 的 任何 路 由 上 指定 
auth:api 中 间 件 : 


Route::get('/user', function () { 


// 


})->middleware('auth:api'); 


当 调 用 Passport 保护 下 的 路 由 时 ， 接 入 的 API 应 用 需要 将 访问 令 牌 作为 Bearer 4 
牌 放 在 请 求 头 Authorization 中 。 例 如 ， 使 用 Guzzle HTTP 库 时 : 


$response = $client->request('GET', '/api/user', [ 
"headers' => [ 
'Accept' => 'application/json', 
'Authorization' => 'Bearer '.$accessToken, 
], 
1); 


auth:api ¥ Ij] 4+ 

当 我 们 已 经 配置 完成 Passport 的 四 种 模式 并 拿 到 access token 之 后 ， 我 们 
就 可 以 利用 令 牌 去 资源 服务 器 获取 数据 了 。 资 源 服务 器 最 常用 的 校 验 令 牌 的 中 间 件 
就 是 auth:api ， 中 间 件 是 auth ， api 是 中 间 件 的 参数 : 


'auth' => NIlluminateNAuthNMiddlewareNAuthenticate::class, 


这 个 中 间 件 是 验证 登录 状态 的 常用 中 间 件 : 


class Authenticate 


{ 
public function __construct(Auth $auth) 
{ 
$this->auth = $auth; 
} 
public function handle($request, Closure $next, ...$guards) 
{ 
$this->authenticate($guards); 
return $next($request); 
} 


protected function authenticate(array $guards) 


{ 
if (empty($guards)) { 
return $this->auth->authenticate(); 


foreach ($guards as $guard) { 
if ($this->auth->guard($guard)->check()) { 
return $this->auth->shouldUse($guard); 


throw new AuthenticationException('Unauthenticated.', $g 
uards); 


j 


我 们 的 参数 api 就 是 上 面 的 guards * Auth Æ laravel 自 带 的 登录 校 验 
服务 : 


class AuthManager implements FactoryContract 


( 


public function guard($name - null) 


( 


$name = $name ?: $this->getDefaultDriver(); 


return $this->guards[$name] ?? $this->guards[$name] = $t 
his->resolve($name) ; 


} 


protected function resolve($name) 


{ 
$config = $this->getConfig($name) ; 


if (is_null($config)) { 
throw new InvalidArgumentException("Auth guard [{$na 
me} ts hot defined. ”); 


} 


if (isset($this->customCreators[$config['driver']])) { 
return $this->callCustomCreator($name, $config); 


$driverMethod = 'create'.ucfirst($config['driver']).'Dri 
ver'; 


if (method_exists($this, $driverMethod)) { 
return $this->{$driverMethod}($name, $config); 


throw new InvalidArgumentException("Auth guard driver [{ 
$name}] is not defined."); 


} 


文档 告诉 我 们 ， 若 想 要 使 用 passport 服务 ， 我 们 的 config/auth 文件 需要 如 
此 配置 : 


Laravel Passport—OAuth2 API 认证 系统 源码 解析 (下 ) 


'guards' => [ 

'web' => [ 
'driver' => 'session', 
'provider' => 'users', 


] 
'api' => [ 
'driver' => 'passport', 
'provider' => 'users', 
] 


], 


可 以 看 出 ， driver 就 是 passport ， 我 们 在 启动 passport 服务 的 时 候 曾经 
注册 过 一 个 Guard 
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protected function registerGuard() 


( 


Auth::extend('passport', function ($app, $name, array $confi 


g) i 


return tap($this->makeGuard($config), function ($guard) 


{ 
$this->app->refresh('request', $guard, 'setRequest' ) 
3); 
3); 
E 
protected function makeGuard(array $config) 
{ 
return new RequestGuard(function ($request) use ($config) ( 
return (new TokenGuard( 
$this->app->make(ResourceServer::class), 
Auth: :createUserProvider($config[ 'provider']), 
$this->app->make(TokenRepository::class), 
$this->app->make(ClientRepository::class), 
$this->app->make('encrypter' ) 
))-»user($request); 
}, $this-»app['request']); 
} 


因此 ， passport 使 用 的 就 是 这 个 TokenGuard 


class TokenGuard 


1 
public function ^ construct(ResourceServer $server, 
UserProvider $provider, 
TokenRepository $tokens, 
ClientRepository $clients, 
Encrypter $encrypter) 
t 
$this->server = $server; 
$this->tokens = $tokens; 
$this->clients = $clients; 
$this->provider = $provider; 
$this->encrypter = $encrypter; 
J 
public function user(Request $request) 
{ 
if ($request->bearerToken()) { 
return $this->authenticateViaBearerToken($request); 
} elseif ($request->cookie(Passport::cookie())) { 
return $this->authenticateViaCookie($request); 
} 
} 
} 


可 以 看 到 ， TokenGuard 支持 两 种 Token 的 验证 : BearerToken 4 


cookie ° 


我 们 首先 看 BearerToken : 


public function bearerToken( ) 


{ 


$header = $this->header('Authorization', ''); 


if (Str::startswith($header, ‘Bearer ')) { 
return Str::substr($header, 7); 


protected function authenticateViaBearerToken($request ) 


{ 


$psr = (new DiactorosFactory) ->createRequest($request ); 


try T 
$psr = $this->server ->validateAuthenticatedRequest($psr ) 


$user = $this->provider->retrieveById( 
$psr->getAttribute( 'oauth_user_id') 
); 


if (! $user) ( 
return; 


$token = $this->tokens->find( 
$psr->getAttribute('oauth_access_token_id') 


); 
$clientId = $psr->getAttribute('oauth_client_id'); 


if ($this->clients->revoked($clientId)) { 
iesu 


return $token ? $user->withAccessToken($token) : null; 
} catch (OAuthServerException $e) { 
return Container: :getInstance( )->make( 
ExceptionHandler::class 
)->report($e); 


首先 ， 需 要 验证 请 求 的 合法 性 : 


class ResourceServer 
{ 
public function validateAuthenticatedRequest(ServerRequestIn 
terface $request) 
x 
return $this-»getAuthorizationValidator()-»validateAutho 
rization($request); 


j 


protected function getAuthorizationValidator() 
{ 
if ($this->authorizationValidator instanceof Authorizati 
onValidatorInterface === false) { 
$this->authorizationValidator = new BearerTokenValid 
ator($this->accessTokenRepository) ; 


} 
$this->authorizationValidator ->setPublicKey($this ->publi 
cKey); 
return $this->authorizationValidator; 
J 
} 


BearerTokenValidator 专门 用 于 验证 BearerToken 的 合法 性 : 


class BearerTokenValidator implements AuthorizationValidatorInte 


rface 
{ 
public function validateAuthorization(ServerRequestInterface 
$request ) 
{ 
if ($request->hasHeader('authorization') === false) { 


throw OAuthServerException::accessDenied('Missing "A 
uthorization" header'); 


} 


$header = $request->getHeader('authorization'); 


$jwt = trim(preg_replace('/4(?:\s+)?Bearer\s/', '', $hea 
der[0])); 


try { 
// Attempt to parse and validate the JWT 


$token = (new Parser())->parse($jwt); 
if ($token->verify(new Sha256(), $this->publicKey->g 
etKeyPath()) === false) { 
throw OAuthServerException::accessDenied('Access 
token could not be verified'); 


} 


// Ensure access token hasn't expired 
$data = new ValidationData(); 
$data->setCurrentTime(time()); 


if ($token->validate($data) === false) { 
throw OAuthServerException: :accessDenied( 'Access 
token is invalid'); 


} 


// Check if token has been revoked 
if ($this->accessTokenRepository->isAccessTokenRevok 
ed($token->getClaim('jti'))) { 
throw OAuthServerException: :accessDenied( 'Access 
token has been revoked'); 


} 


// Return the request with additional attributes 
return $request 
-»withAttribute('oauth access token id', $token- 
>getClaim('jti')) 
->withAttribute('oauth_client_id', $token->getCl 
aim('aud')) 
-»withAttribute('oauth user id', $token->getClai 
m('sub')) 
-»withAttribute('oauth scopes', $token->getClaim( 
'scopes' )); 
} catch (NInvalidArgumentException $exception) { 
// JWT couldn't be parsed so return the request as is 


throw OAuthServerException: :accessDenied($exception- 
>getMessage()); 
} catch (\RuntimeException $exception) { 
//JWR couldn't be parsed so return the request as is 
throw OAuthServerException::accessDenied('Error whil 
e decoding to JSON'); 


通过 passport $2149 access token 都 是 JWT 格式 的 ， 因 此 首先 第 一 步 需 
要 将 JWT 解析 : 


class Parser 


public function parse($jwt) 


{ 
$data = $this->splitJwt($jwt); 
$header = $this-»parseHeader($data[9]); 
$claims = $this->parseClaims($data[1]); 
$signature = $this->parseSignature($header, $data[2]); 


foreach ($claims as $name => $value) { 
if (isset($header[$name])) { 
$header[$name] = $value; 


if ($signature === null) { 
unset ($data[2]); 


return new Token($header, $claims, $signature, $data); 


protected function splitJwt($jwt) 


{ 
if (!is_string($jwt)) { 


throw new InvalidArgumentException('The JWT string m 
ust have two dots'); 


} 


$data = explode('.', $jwt); 


if (count($data) != 3) { 
throw new InvalidArgumentException('The JWT string m 
ust have two dots'); 


} 


return $data; 


protected function parseHeader ($data) 


{ 
$header = (array) $this->decoder ->jsonDecode($this->deco 
der ->base64Ur1Decode($data) ); 


if (isset($header['enc'])) { 
throw new InvalidArgumentException('Encryption is no 
t supported yet'); 
} 


return $header; 


protected function parseClaims($data) 


t 
$claims = (array) $this->decoder ->jsonDecode($this->deco 
der ->base64Ur1Decode($data) ); 


foreach ($claims as $name => &$value) { 


$value = $this->claimFactory->create($name, $value); 


return $claims; 


protected function parseSignature(array $header, $data) 


if ($data == '' || 


!isset($header['alg']) 
gil == none.) { 


|| $header[ ' al 


return null; 


$hash = $this->decoder ->base64Ur1Decode($data) ; 


return new Signature($hash); 


获得 JWT 的 三 个 部 分 之 后 ， 就 要 验证 签名 部 分 是 否 合法 : 


class Token 


{ 
public function verify(Signer $signer, $key) 
{ 
if ($this->signature === null) { 
throw new BadMethodCallException('This token is not 
signed'); 
} 
if ($this->headers['alg'] !== $signer->getAlgorithmId()) 
{ 


return false; 


return $this->signature->verify($signer, $this->getPaylo 
ad(), $key); 


} 


验证 通过 之 后 ， 就 要 验证 JWT 各 个 部 分 


$data = new ValidationData(); 


$data->setCurrentTime(time()); 


public function __construct($currentTime = null) 


{ 


$currentTime = $currentTime ?: time(); 


$this->items [ 

yt “nul 

'iss' => null, 

'aud' => null, 

'sub' => null, 

'iat' => $currentTime, 
'nbf' => $currentTime, 
'exp' => $currentTime 


1; 


public function validate(ValidationData $data) 
{ 
foreach ($this->getValidatableClaims() as $claim) { 
if (!$claim->validate($data)) { 
return false; 


return true; 


public function __construct(array $callbacks = []) 
{ 
$this->callbacks = array_merge( 
[ 
'iat' => [$this, 'createLesserOrEqualsTo' ], 
'nbf' => [$this, 'createLesserOrEqualsTo' ], 
'exp' => [$this, 'createGreaterOrEqualsTo'], 
'iss' => [$this, 'createEqualsTo'], 
'aud' => [$this, 'createEqualsTo'], 
'sub' => [$this, 'createEqualsTo'], 
'jti' => [$this, 'createEqualsTo' ] 
], 
$callbacks 


); 


我 们 前 面 说 过 ， 


e aud 客户 端 id 

jti access_token 随机 码 

iat 生成 时 间 

nbf 拒绝 接受 jwt 时 间 

exp access token 失效 时 间 
sub 用 户 id 


因此 ， JWT 的 生成 时 间 、 拒 绝 接受 时 间 、 失 效 时间 就 会 被 验证 完成 。 


接 下 来 ， 还 会 验证 最 重要 的 access token 


if ($this->accessTokenRepository->isAccessTokenRevoked($token->g 
etclaim('jti'))) { 

throw OAuthServerException::accessDenied('Access token has b 
een revoked'); 


j 


public function isAccessTokenRevoked(S$tokenId) 


( 


return $this->tokenRepository->isAccessTokenRevoked($tokenId 


); 


public function isAccessTokenRevoked ($id) 


{ 
if ($token = $this->find($id)) ( 
return $token->revoked; 
} 
return true; 
} 


接 下 来 ， TokenGuard 就 会 验证 userid ^ clientid 与 access_token 的 
合法 性 : 


$user = $this->provider->retrieveById( 
$psr-»getAttribute('oauth user id') 
); 


if (! $user) ( 


return 


$token = $this->tokens->find( 
$psr->getAttribute('oauth_access_token_id') 


); 
$clientId = $psr->getAttribute('oauth_client_id'); 
if ($this->clients->revoked($clientId)) { 


return; 


return $token ? $user->withAccessToken($token) : null; 
中 间 件 验证 完成 。 


客户 端 模式 中 间 件 CheckClientCredentials 


我 们 在 上 面 可 以 看 到 auth:api 中 间 件 不 仅 验证 access token ， 还 会 验证 
user id ， 对 于 客户 端 模式 来 说 ， 由 于 JWT 中 并 没有 用 户 信息 ， 因 此 
passport 专门 存在 中 间 件 CheckClientCredentials 来 做 非 登 录 状 态 的 校 


验 。 


class CheckClientCredentials 


{ 
public function handle($request, Closure $next, ...$scopes) 
{ 
$psr = (new DiactorosFactory) ->createRequest($request ); 
try { 
$psr = $this->server ->validateAuthenticatedRequest($ 
psr); 
} catch (OAuthServerException $e) { 
throw new AuthenticationException; 
} 
$this->validateScopes($psr, $scopes); 
return $next($request); 
} 
} 


使 用 JavaScript # API 


在 构建 API > to R 6638 JavaScript 应 用 接 入 自己 的 API 将 会 给 开发 过 程 带 来 
极 大 的 便利 。 这 种 API 开发 方法 允许 你 使 用 自己 的 应 用 程序 的 API 和 别人 共享 的 
API。 你 的 Web 应 用 程序 、 移 动 应 用 程序 、 第 三 方 应 用 程序 以 及 可 能 在 各 种 软件 包 
管理 器 上 发 布 的 任何 SDK 都 可 能 会 使 用 相同 的 API 。 


通常 ， 如 果 要 从 JavaScript 应 用 程序 中 使 用 API， 则 需要 手动 向 应 用 程序 发 送 访问 
令 牌 ， 并 将 其 传递 给 应 用 程序 。 但 是 ，Passport 有 一 个 可 以 处 理 这 个 问题 的 中 间 
件 。 将 CreateFreshApiToken 中 间 件 添加 到 web 中 间 件 组 就 可 以 了 : 


'web' => [ 
// Other middleware... 
\Laravel\Passport\Http\Middleware\CreateFreshApiToken: :class 


Passport 的 这 个 中 间 件 将 会 在 你 所 有 的 对 外 请 求 中 添加 一 个 laravel_token 

cookie ° % cookie 将 包含 一 个 加 密 后 的 JWT > Passport 将 用 来 验证 来 自 
JavaScript 应 应 用 程序 的 API 请 求 。 至 此 ， 你 可 以 在 不 明确 传递 访问 令 牌 的 情况 下 向 
应 用 程序 的 API 发 出 请 求 


axios.get('/user') 
.then(response => { 
console.log(response.data); 


3); 


当 使 用 上 面 的 授权 方法 时 ，Axios 会 自动 带 上 X-CSRF-TOKEN 请 求 头 传 递 。 另 
bF > BRUKI Laravel JavaScript 脚手架 会 让 Axios 发 送 X-Requested-With 请 求 头 : 


window.axios.defaults.headers.common = { 
'X-Requested-With': 'XMLHttpRequest', 
J; 


CreateFreshApiToken ¥ i8] £F 


class CreateFreshApiToken 
{ 

public function handle($request, Closure $next, $guard = nul 
18) 

{ 


$this->guard = $guard; 
$response = $next($request); 
if ($this->shouldReceiveFreshToken($request, $response) ) 
$response->withCookie($this->cookieFactory ->make( 
$request ->user($this->guard)->getKey(), $request 


->session()->token() 


2): 


return $response; 


public function make($userId, $csrfToken) 


{ 
$config = $this->config->get('session'); 
$expiration = Carbon: :now()->addMinutes($config['lifetim 
e']); 
return new Cookie( 
Passport: :cookie(), 
$this->createToken($userId, $csrfToken, $expiration) 
$expiration, 
$config[ 'path'], 
$config['domain'], 
$config['secure'], 
true 
); 
} 
protected function createToken(S$userlId, $csrfToken, Carbon $ 
expiration) 
{ 


return JWT: :encode([ 

'sub' => $userId, 

'csrf' => $csrfToken, 

'expiry' => $expiration->getTimestamp(), 
], $this->encrypter->getKey()); 


} 
protected function shouldReceiveFreshToken($request, $respon 
se) 
{ 
return $this->requestShouldReceiveFreshToken($request) & 
& 


$this->responseShouldReceiveFreshToken($response ) 


protected function requestShouldReceiveFreshToken($request ) 


{ 
return $request->isMethod('GET') && $request->user($this 
->guard); 
} 


protected function responseShouldReceiveFreshToken($response) 


return $response instanceof Response && ! $this->already 
ContainsToken($response); 


j 


BEI yj 


这 个 中 间 件 发 出 的 JWT 令 牌 仍然 由 auth:api 来 负责 验证 ， 我 们 前 面 说 
过 ， TokenGuard 
个 


负责 两 种 令 牌 的 验证 ， 一 种 是 BearerToken , 另 一 种 就 是 这 
Cookie 


public function user(Request $request ) 


{ 
if ($request->bearerToken()) { 
return $this->authenticateViaBearerToken($request ); 
} elseif ($request->cookie(Passport::cookie())) { 
return $this->authenticateViaCookie($request); 
} 
} 


protected function authenticateViaCookie($request ) 


{ 
Lr 
$token = $this->decodeJwtTokenCookie($request ); 
) catch (Exception $e) { 
return; 


if (! $this->validCsrf($token, $request) | | 
time() >= $token['expiry']) { 
return; 


if ($user = $this->provider->retrieveById($token['sub'])) { 
return $user->withAccessToken(new TransientToken) ; 


protected function decodeJwtTokenCookie($request ) 


{ 


return (array) JWT::decode( 
$this->encrypter->decrypt($request->cookie(Passport::coo 


kie())), 
$this->encrypter->getKey(), ['HS256'] 


); 


protected function validCsrf($token, $request ) 


{ 
return isset($token['csrf']) && hash_equals( 
$token['csrf'], (string) $request->header('X-CSRF-TOKEN' 


): 


